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SHIAIS ロ 


本 書 は 、X68030 対 応 に 拡張 され た ツー ル の 説明 や 、Human68k ver3.0、ASK ver3.0 
で 拡張 され た 機能 、OPMDRV3/SCSI/GPIB/RS232C に つい て 記述 し て いま す 。 
な お 、 別 世 の 「C ユ ー ザ ー ズ マニ ュ ア ル 」| に 「C compiler PRO-68K ver.2.1 NEW 
KIT| の 商品 構成 、 動 作 環境 の 作成 方 法 、 各 マニ ュ ア ル の 内 容 が 説明 され て いま 
す 。 

初め て 本 プロ グラ ム を ご 使用 に な る 方 は 、 必 ず 「C ユ ー ザ ー ズ マニ ュ ア ル 」 を 先 に 
ご 覧 くだ さい 。 


本 書 の 構成 


本 書 で は 、X68030 , Human68k ver.3.0 , ASK ver3.0 の 登場 に より 従来 の バー ジョ ン よ り 変 
更 が あっ た 部 分 に つい て お も に 説明 を し て いま す 。 本書 の 内 容 を よく お 読み に な り 、 ア 
プリ ケー ショ ン ソ フト の 開発 の 際 に 、 お 役立て くだ さい 。 

本 書 は 、 次 の 4 章 と 付録 か ら 構 成 さ れ て いま す 。 


第 1 章 X68030 対 応 ツ ー ル 
MC68EC030 を 搭載 し た X68030 用 に 対応 し た 各種 開発 ツー ル の 変更 点 に つい て 説明 し て い 
まま 。 


第 2 草 バー ジョ ン 3.0 シ ステ ム 


Human68k な どの シス テム の バー ジョ ン ア ッ プ 内 容 に つい て 説明 し て いま す 。 


第 3 章 追加 ライ ブラ リ 


追加 され た 各種 ライ プラ リ に つい て の 説明 を し て いま す 。 


第 4 革 追加 DOS/IOCS コ ー ル 


拡張 され た DOS/IOCS コ ー ル に つい て 説明 し て いま す 。 


付録 


従来 の X68000 と X68030 の 両方 で 動作 する アプ リケーション ソフ ト を 開発 する た め の 互 換 


性 に 関す る 注意 点 や エラ ー コ ー ド な ど を 説明 し て いま す 。 


な お 、 書 式 の 説明 に あたっ て は 以下 の 表記 を 使用 し ます 。 


マッ > ・: 指定 が 必要 で ある こと を 示し ます 。 
[] : 指定 が 省略 可能 で ある こと を 示し ます 。 
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アセ ン ブ ラ (AS) 
リン カ (LK) 
デバ ッ ガ (DB) 
ソー スコ ー ド デバ ッ ガ (SCD) 
SYNC 


アセ ン ブ ラ (AS) 
こと で は 、 ア セン プラ XAssembler ver.3.0 で 追加 され た 仕様 や 疑似 命令 に つい て 説明 し ます 。 


居間 本 較 追加 仕様 の 一 覧 


信 追 加 さ れ た 文字 セッ ト 
実効 アド レス 表記 、 ビ ッ ト ・ フ ィ ー ル ド そ の 他 の 表記 用 の た め に 、 以 下 の 文 
字 セ モット が 追加 され まし た 。 


II 


信 追 加 さ れ た レジ スタ 名 
MC68EC030 な ら び に EPCP で 追加 され た 、 新 し い レ ジス タ が 使用 で きる よう に 
な り ま し た 。 


MSP,ISP 

SFC,DFC,VBR 

CASR,CACR 
TTO(ACO),TT1(AC1).MMUSR(ACUSR) 


FPO,FP1.FP2,FP3,FP4.FPS,FP6.FP7 
FPCR,FPSR,FPIAR 


な お 、ACO,AC1.ACUSR レ ジス タ を ご 使用 の 際 は 、 ソ ー ス プロ グラ ム 上 で は 、 
それ ぞ れ TTO.TT1.MMUSR と 記述 し て くだ さい 。 

また 特定 の アド レッ シン グモ ー ド に お いて 、PC・An・Dn を 省略 する (0 サ プ 
レス ) た め に 使用 する 疑似 レジ スタ 名 は 以下 の 通り で す 。 


ZPC,ZA0 一 ZD7.ZR0 一 ZR15 
@ 追 加 さ れ た サイ ズ 指 定子 


以下 の サイ ズ 指 定子 が 追加 され ま し た 。 
な お 該当 する 命令 以外 の 場所 で 、 こ れ ら の サイ ズ 指 定子 を 使っ た 場合 に は エ 


ラ っ 2 な り ま io 

.S 単 精度 実数 浮動 小数 点 命令 
.D 倍 精 度 実数 浮動 小数 点 命令 
文 拡張 精度 実数 浮動 小数 点 命令 
JP パッ ク ド デ シマ ル 実 数 肖 動 小数 点 命令 


@ び アド レッ シン グモ ー ド 書式 


li 1 


アド レッ シン グモ ー ド は 次 の 書式 を 採用 し ます 。 


従来 の 書式 が 空欄 に な っ て いる アド レッ シン グモ ー ド が MPU68030 以 上 で 追加 


だ 7 ドレ タジン グモ ー ド で すま 。 


従来 の 書式 と 異な る る の に つい て は 併用 可能 と な っ て いま す 。 


PC 29 や の の め お で ぐ や ロ 


mm 呈 
ーー 


(An) 

(An) 十 
ー(An) 
(d16,An) 

(d8,An,Rn* scale) 
(bd,An,Rn* scale) 
([bd,An],Rn 玉 scale,od) 
([bd,An,Rn scale],od) 
XXXX.W 
XXXX.1 


(d16.PC) 


。 (d8,PC,Rn* scale) 


(bd,PC,Rn* scale) 
([bd,PC],Rn * scale,od) 
([bd,PC,Rn * scale],od) 


、#IMM 


従来 の 書式 
Dn 

An 

(An) 
(An) 十 
ー(An) 
d16(An) 
d8(An,Rn) 


XXXX.W 
XXXX.1 
d16(PO) 
d8(PC,Rn) 


#IMM 


・ 139、 9⑨・16。、10・ 17 番 で は ディ スプレー スメント 、 ペ ー ス レジ スク 及び が 


イン デック スレ ジス タ を 省略 する こと が で きま す 。 


また ディ スプ レー スメント の 表記 その も の を 省略 する こと が で きま す 。 


例 : 


ベー スレ ジス タ 及 び イ ン デ ックス レジ スタ の サ プ レ ス は 、 レ ジス タ 名 の 先頭 


(a0,dO) 
(lpcl,d0) 


に 光学 Z を つけ ます 。 


アセ ンプ ラ %AS) 
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例 : (Zpc,dO) 
(40,zd7) 
念 例外 的 な オペ ラン ド 表 記 


通常 、 オ ペラ ンド の 記述 は アド レッ シン グ 表 記 の 文法 に し た が わな く て は な 
り ま せん が 、 以 下 の 特 定 の 命令 の 後に は 例外 的 な オペ ラン ド 表 記 が 許さ れ ま 


す 。 

ビッ ト フ ィ ー ル ド 命 令 bf29292 ぐ ea> [offset:width] 
CAS CaS Dn,Dn, ぐ ea 

CAS2 cas2 Dn:Dn,Dn:Dn, く ea >: ぐ ea 
64 ビ ッ ト 乗 算 mul7 ぐ ea>,Dn:Dn 

64 ビ ッ ト 除 算 div?9 ぐ ea>,Dn:Dn 

PTEST ptest7 ぐ ea>, ぐ ea>, 氏 MM 
PTEST Dtest7 ぐ ea シ , ぐ ea IMM,An 
FMOVE fmove.p FPn, ぐ ea {Dnj] 
FMOVE fmove.p FPn, ぐ ea> {#IMM) 
FSINCOS fsincos ぐ ea>,FPn,FPn 


で 浮動 小数 点数 の サポ ー ト 
次 の よう な 書式 の 浮動 小数 点数 表記 が サポ ー ト され まし た 。 


書式 : [符号 ] [数 字 ] [. 数 字 ] [E [符号 ] 数 字 ] 
例 : 十 12 

3.1415 

123e23 

ー6.023e 十 24 


な お 以下 の よう な 場所 に 浮動 小数 点 定数 を 記述 する こと が で きま す 。 


・ 浮 動 小 数 点 命 令 の オペ ラン ド 
・fsetfequ 疑似 命令 の 値 
・dc.f dc.d dc.x dc.p 疑似 命令 で 定義 する 値 


1 。 1 セン ザラ AS) 


アセ ンプ ブラ の 演算 子 を 使っ て 演算 を 行っ た と き 、 小 数 点 以下 切り 捨て が 行 
われ ます 。 式 の 値 は 整数 と な り 、 上 記 以 外 の 整数 値 が 記述 で きる 部 分 に 計 
述 す る こと が で きま す 。 


例 : MOVE #2.5 十 1.A0 **move 3#33.a0 と 等 価 


久 追 加 さ れ た コマ ンド ライ ン オ プシ ョ ン 

シン ボル を 定義 する オプション を 拡張 し ます 。 

/s ぐ symbol> [=<num>] 

シン ボル を 定義 し 、 値 を 与え ます 。 省略 し た と き の 値 は 0 と な り ま す 。 
@ 追 加 拡張 され た 命令 セッ ト 


追加 拡張 され た 命令 セッ ト に つい て は イン スト ラク ショ ンコ ー ド マニ ュ ア 
ル を ご 参照 くだ さい 。 


人 追加 され た 疑似 命令 
次 ペー ジ 以 降 に 示す 疑似 命令 が 新た に 追加 され まし た 。 
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.「ept マク ロ 定 義 
書 式 | repk< 式 > 
マク ロ 定 義 を 行い ます 。 


マク ロ 定 義 命令 で す 。 rept 一 endm の 間 の 命令 を マク ロ と し て 定義 し ます 。 
展開 時 に く 式 > で 与え られ る 回 数 だ け 繰り 返し て 展開 し ます 。 


DP ニーーーーーーー マ ーー ーーーー マラ タロ 定義 | 
rp ぐ 仮 引数 >, 実 引数 >, [, く 実 引数 >.…」] 
マク ロ 定 義 を 行い ます 。 


解 説 | マク ロ 定 義 命令 で す 。 im 一 endm の 間 の 命令 え マ クロ と し て 定義 し ます 。 
展開 時 に ぐ く 実 引数 > を ぐ 仮 引数 > に 置き 換え て 展開 し ます 。 実 引数 リス ト が 
な く な る まで 繰り 返し て 展開 し ます 。 


1。 1 アセン プラ AS 


.irpc 二 
jmpc く 仮 引数 >. く 文字 列 > 


機 能 | マク ロ 定 義 を 行い ます 。 


マク ロ 定 義 命 令 で す 。impc 一 endm の 間 の 命令 え マ クロ と し て 定義 し ます 。 
展開 時 に ぐ く 文字 列 > 中 の 1 文字 を ぐ 仮 引数 > に 置き 換え て 展開 し ます 。 文字 


が な く な る まで 繰り 返し て 展開 し ます 。 


-allgn アラ イン 指定 
aiign アラ イン 値 >,< 式 > [wl 
機 能 | アラ イン 指定 を 行い ます 。 


解 説 | .align 疑 似 命令 の 次 に 記述 され て いる 命令 $ し く は デー タ を 、 ぐ アラ イン 値 > 
で 指定 し た 値 の 倍数 の アド レス に 配置 し 、 そ の アド レス まで ぐ 式 > の 値 で 満 
た 尼 ま 3 あ 5 


注 意 | アセ ン ブ ル 後 は 、_.align 疑 似 命令 を 使用 し て いた と いう 情報 は 、 オ プ ジ ェ クト 
ファ イル に は 保存 され な いた め 、 複 数 の オプ ジェ クト ファ イル を リン ク す る 
際 は 、 ソ ー ス ファ イル で 使用 し た アラ イン 値 の 最大 値 を リン カ (LKX) の /c 
スイ ッ チ で 指定 する よう に し て くだ さい 。 な お 単独 の オプ ジェ クト を リン ク 
する 場合 は 必要 あり ませ ん 。 


ま た 、 実 行 フ ァイル を 固定 アド レス に ロー ド す る 場合 以外 は 、 ア ライ ン 値 と 
し て 16 を 越え る 値 を 指定 し な いよ うに し て くだ さい 。 


第 1 章 X68030 対 応 ツ ー ル 


に CD ローーーー ーー 5 茎 ] 
cpu く MPU 名 > 
アセ ンプ ラ の 動作 モー ド を 指定 し ます 。 


MPU68000.MPU68030 を それ ぞ れ 指定 可能 に し ます 。 そ れ ぞ れ の モー ド で 記述 
で きる アセ ンプ ラ ソ ー ス の 内 容 に つい て は 、「 1-1-2 MPU モ ー ド に よる 
機能 の 人 違い] を ご 参照 くだ さい 。 


例 .CDU 68030 


| fedU 浮動 小数 点数 シン ボル 定義 | 
こく シン ボル > fequ く 式 > 
浮動 小数 点 を 示す ナシ ン ボ ル を 定義 し ます 。 


解 浮動 小数 点数 シン ボル を 定義 し ます 。 


1. 1 アセ ン ブ ラ (AS) 


Tset 浮動 小数 点数 シン ボル 定義 
< く シンボル > fset く 式 > 
浮動 小数 点 を 示 ナ シン ボル を 定義 し ます 。 


浮動 小数 点数 シン ボル を 定義 し ます 。 


| 定数 定義 
拡張 点 dc.s dc.d dc.x dcp に 対応 し ます 
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上 居 呈 説 信 MPU モ ー ド に よる 機能 の 違い 


@ び MPU モ ー ド 
アセ ンプ ラ は .cpu 疑 似 命令 に よっ て アセ ンプ ル の 対象 と する MPU を 切り 替え 
ます 。 


切り 替え 可能 な モー ド に は 、 次 の 2 つが あり ます 。 


・MPU68000 モ ー ド : 従来 の アセ ンプ ラ の 標準 モー ド で す 
・MPU68030 モ ー ド : MPU68EC030 の 命令 に 対応 する モー ド で す 


僅 レ ジス タ 名 


グル ー プ 68000 | 68030 
ャ ーー 


DO,D1,D2,D3.D4,DS,D6,D7,A0,A1,A2.A3.A4.A5,A6.A7, 
RO.R1.R2.R3.R4.RS,R6,R6.R7.R8.R9,R10.R11.R12, 〇 ' 
R13.R1S,R15,SP,USP,CCR,SR.PC 


SFC,DFC,VBR,ISP,MSP 入 
CAAR,CACR,TTO.TT1MMUSR 〇 
ZPC,ZA0 一 ZD7.ZR0 一 ZR15 〇 
| FPO.FPLFP2FP3FP4.FP5.FP6FP7.FPCRFPSRJFPIAR 〇 
@ サ イズ 指定 子 
サイ ズ 指 定子 | 68000 | 68030 
.B バイ ト 〇 〇 
.W ワー ド 〇 〇 
M ロン グ ワ ー ド 〇 
.S ショ ー ト (8 ビット) 〇 〇 
.S 単 精度 実数 〇 
D 倍 精 度 実数 〇 
X 拡張 精度 実数 O 
P パッ ク 1 0 進 実数 〇 
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1 。 1 末 も セン シン ズラ (AS 


欠 ア ドレ ッ シ ン グモ ー ド 
従来 の 書式 と 併用 可能 な 書式 に つい て は 全て の モー ド に つい て 併用 が 可能 で 
す 。 


略 アド レッ シン グ ・ モ ー ド 68000 | 68030 
Dn 〇 Q 
An 〇 〇 
(An) 〇 〇 
(An) 十 〇 〇 
ー(An) 〇 〇 
(d16,An) d16(An) 〇 〇 
(d8,An,Rn.size*scale)  d8(An,Rn) (つう 〇 
(bd,An,Rn.size ※ scale) 〇 
([bd,An],Rn.size scale,od) ⑳) 
([bd,An,Rn.size ま scale],od) (9) 
XXXX.W 〇 〇 
XXXX.1 〇 〇 
(d16,PC) d16(PC) 〇 ( 凍 
(d8.PC.Rn.size 玉 scale) DS8(PC.Rn) 〇 〇 
(bdJPC,Rn.size 玉 scale) ( 〇 ) 
([bd,PC],Rn.size * scale,od) 〇 
([bd,PC,Rn.size* scale],od) 〇 
打 MM 〇 〇 


@ び コマ ンド ライ ン オ プシ ョ ン と 疑似 命令 
すべ て の モー ド で コマ ンド ライ ン オ プシ ョ ン と 疑似 命令 の 拡張 部 分 が 使え ま 
す (MPU68000 モ ー ド で も dc.f な ど が 記述 で きま す ) 。 


介 命 令 


モー ド に 有効 な 命令 セッ ト に つい て は 、 イ ンス トラ クシ ョ ンコ ー ド マニ ュ ア 
ル を ご 参照 くだ さい 。 
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旧 呈 本 K 久 オブ ジェ クト ファ イル の 拡張 


オプ ジェ クト ファ イル 形式 が 1 ヶ所 拡張 され て いま す 。 

PC 相対 アド レス の 分 岐 命令 (Bcc.BRA,BSR) で 、32 ビ ッ ト デ ィ ス プレ ー ス メン 
ト を 指定 で きる よう に な っ た た め 、 分 岐 先 ア ドレ ス が 外部 参照 の 場合 、 拡 張 
され た オプ ジェ クト ファ イル 形式 で オプ ジェ クト ファ イル を 出力 し ます 。 


例 : .xref label 


bsr.1 label 
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リン カ (LK) 


ここ で は 、 リ ンカ XLinker ver.3.0 で 追加 され た 機能 スイ ッ チ に つい て 説明 し ます 。 


久 追 加 機能 
bra.1 命 令 で 外部 シン ボル を 指定 で きる よう に な り ま し た 。 
また 追加 され た スイ ッ チ は 、 次 の 2 つ で す 。 


Aa 実行 ファ イル ロー ド メ モ リエ リア 指定 
胡 オプ ジェ クト アラ イン 指定 


屋 ん た 実行 ファ イル ロー ド メ モ リエ リア 指定 | 
[書式 | Aa <m] 
実行 ファ イル を どの メモ リエ リア に ロー ド す る か を 指定 し ます 。 


解 説 この スイ ッ チ を 指定 し な い 場 合 、 実 行 フ ァイル は 、 通 常 の メモ リエ リア に 
ロー ド さ れ 実 行き さき れ ま す 。 
n 三 0 を 指定 し た 場合 、 必 要 な メモ リ の 最小 構成 エリ ア に 実行 ファ イル が ロー 
ド さ れ ま す 。 こ の 場合 、 後 に 自分 の エリ ア を 増やす こと と が で き な く な る 可能 
性 が あり ます 。 常 太 し た り 、 解 放し た りす る よう な プロ グラ ム の 場合 は 、 こ 
の スイ ッ チ を 指定 し て リン ク す る と 、 毎 回 同じ メモ リエ リア に ロー ド さ れる 
可能 性 が あり ます 。 
n 三 1 を 指定 し た 場合 、 必 要 な メモ リ を 管理 エリ ア の 最後 か ら 確保 し て 、 そ こ 
に 実行 ファ イル が ロー ド さ れ ま す 。 n テ 0 の 場合 と 同様 に 、 後 に 自分 の エリ ア 
を 増やす こと が で き な く な る 可能 性 が あり ます 。 常駐 する プロ グラ ム を ロー 
ド す る 実行 ファ イル は 、 こ の オプ ショ ン を つけ て リン ク し て くだ さい 。 


例 /a ス イッ チ の 使用 例 を 以下 に 示し ます 。 


LK /a 1 object1 object2 
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1. 2 六 准 (EK) 


に ーーーーーーーーー デ ーー ラッ クト アラ イン 指定 | 
書 式 [cc < ぐ mnn>] 


機 能 | ソー スプ ログ ラム 内 の .align 命 令 か ら 始 まる プロ ッ ク を 、 ど の 境界 か ら 配 置 し 
た いか を 指定 し ます 。 


解 説 | 通常 は この スイ ッ チ を 指定 する 必要 は あり ませ ん が 、X68030 で .align 命 令 を 
使っ た プロ グラ ム を リン ク す る 際 に 指定 し ます 。long 境 界 か ら コ ー ド を 配置 し 
た いと か 、 キ ャ ッシュ を バー スト モー ド で 使う た め に 16 バ イト 境界 か ら 、 
コー ド を 配置 し た い 場合 な ど に 指定 し ます 。 
nn の 値 と し て は 、2.4.8.16,‥…,32768 な どの 2 の べき 乗数 を 指定 し て くだ さい 。 
指定 し な い 場 合 は 、 2 を 指定 し た の と 同じ 扱い に な り ま す 。 な お 16 以 上 の 値 
を 指定 し た 場合 、 実 行 フ ァイル が ロー ド さ れる アド レス を 固定 し な いと 、 適 
当 な 16 バ イト 境界 に ロー ド さ れる た め 、 無 効 と な る 場合 が あり ます 。 


/ ス イッ チ の 使用 例 を 以下 に 示し ます 


LK /e 16 object1 object2 
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デバ ッ ガ (DB) 


ここ で は 、 デ バッ ガ XDebuggerver.3.0 で 、 内 容 が 変化 し た コマ ンド の 拡張 部 分 に つい て 説 
明 し ます 。 


人 @ 機 能 が 拡張 され た コマ ンド 
A 
AN 
B.BC,BD.BE,BR 
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1 凍 


3 デパ ッ ガ 寺 有 も ) 


aa 


A [ベア ドル スッ >] 


AN [< く ア ドレ スッ >] 


ニー モニ ッ ク の 1 行 ア モン プル 


MPU68000・DOS コ ー ル ・FE フ ァ ン クシ ョ ンコ ー ル ニー モニ ッ ク の アセ ンプ 
ル に 加え 、MPU68030・FPCP68882 の ニー モニ ッ ク の アセ ンプ ブル を サポ ー ト し 
て いま す 。 ま た A コ マン ド を 利用 する 場合 、 キ ー ボ ー ド か ら ESC V と 入力 す 
る こと で 、 現 在 の アド レス の ニー モニ ッ ク を 取り 込み 、 編 集 す る こと が で き 


ます 。 


な お ニー モニ ッ ク と し て は 、 以 下 の も の が 用 意 さ れ て いま す 。 詳細 は 別冊 の 
「 イ ンス トラクション コー ド マ ニ ュ ア ル | を ご 参照 くだ さい 。 


人 WMPU68000 用 ニー モニ ッ ク 


ABCD 
ADDQ 
ASL 
BEO 
BLE 
BNE 
BCHG 
BSR 
CMP 
DBCC 
DBRA 
DBLE 
DBNE 
DBVS 
EOR 
JMP 
LSL 
MOVEM 
MULU 
NOP 
PEA 
ROXL 
RTS 
SEO 
SHI 
SMI 
SVC 
SUBA 
SWAP 
TST 


ADD 
ADDX 
ASR 
BOGE 
BLS 
BPL 
BCLR 
BTST 
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X68030 対 応 ツ ー ル 


@MPU68030 用 ニー モニ ッ ク 


BFCHG 
BFSET 
BKPT 
CMP2 
ILLEGAL 


TRAPLE 
TRAPNE 
TRAPVS 


BFCLR 
BFTST 
CAS 
DIVSL 
MOVEC 
PMOVEFD 
TRAPCC 
TRAPGE 
TRAPLS 
TRAPPL 
UNPK 


@FPCP68882 用 ニー モニ ッ ク 


FABS 
FATAN 
FBGE 
FBLE 
FBNGL 
FBNLT 
FBOLE 
FBSEQ 
FBT 
FBULE 
FCOS 
FDBGE 
FDBLE 
FDBNGLE 
FDBOGE 
FDBOLT 
FDBUGT 
FDBNE 
FDBSNE 
FETOX 


FACOS 
FATANH 
FBGL 
FBLT 
FBNGLE 
FBOOE 
FBOLT 
FBSF 
FBUEO 
FBULT 
FCOSH 
FDBGL 
FDBLT 
FDBNGT 
FDBOGL 
FDBOR 
FDBULE 
FDBRA 
FDBST 
FETOXM1 
FINTRZ 
FLOGNP1 
FMOVEM 
FREM 
FSEO 
FSGLDIV 
FSIN 
FSLT 
FSNGLE 
FSOGE 


FBSNE 
FBUGE 
FBUN 
FDBEO 
FDBGLE 
FDBNOE 
FDBNLE 
FDBOGT 
FDBUEO 
FDBULT 
FDBSEO 
FDBT 
FGETEXP 
FLOG10 
FMOD 
FMUL 
FRESTORE 
FSF 
FSGLE 
FSINCOS 
FSNE 
FSNGT 
FSOGL 


FBST 
FBUGT 
FCMP 
FDBF 
FDBGT 
FDBNGL 
FDBNLT 
FDBOLE 
FDBUGE 
FDBUN 
FDBSF 
FDIV 
FGETMAN 
FLOG2 
FMOVE 
FNEG 
FSAVE 
FSGE 
FSGLMUL 
FSINH 
FSNOE 
FSNLE 
FSOGT 


FSOLE 
FSSEO 

FST 

FSUGT 
FTAN 
FTRAPF 
FTRAPGT 
FTRAPNGL 
FTRAPNGE 
FTRAPOGT 
FTRAPUEO 
FTRAPULT 
FTRAPSNE 
FTWOTOXX 


FSOLT 
FSSF 

FSUB 
FSULE 
FTANH 
FTRAPGE 
FTRAPLE 
FTRAPNGLE 
FTRAPNGT 
FTRAPOLE 
FTRAPUOE 
FTRAPUN 
FTRAPST 


@ び DOS コ ー ル ニー モニ ッ ク 


_ASSIGN 


_CHANGE_PR 


_CHMOD 
_COMMON 
_COUTSNS 
_CURDRV 
_DRVCTRL 
_DUPO 
_EXIT 
_FFLUSH 
_FILES 
_GET_PR 
_GETDPB 
_GETSS 
_INDOSFLG 
_INTVCS 
_KEYSNS 
_LOCK 
_MFREE 
_NEWFILE 
_PRINT 
_PUTCHAR 
_S_MALLOC 
_SEND_PR 
_SETPDB 
_SUPER 
_VERIFY 
_WRITE 


_ALLCLOSE 
_CHDIR 
_CINSNS 
_COMOUT 
_CREATE 
_DELETE 
_DRVXCHG 
_DUP2 
_EXIT2 
_-FGETC 
_FNCKEY 
_GETC 
_GETENV 
_GETTIM2 
_INKEY 
_IOCTRL 
_KFLUSH 
_MAKETMP 
_MKDIR 
_NFILES 
_PRNOUT 
_READ 
_S_MFREE 
_SETBLOCK 
_SETTIM2 
_SUPER_JSR 
_VERIFYG 


1. 3 デバ ッ ガ (DB) 


_BREAKCK 
_CHDRV 
_CLOSE 
_CONCTR 
_CTRLVC 
_DISKRED 
_DSKFRE 
_ERRJVC 
_EXITVC 
_FGETS 
_EPUTC 
_GETCHAKR 
_GETPDB 
_GETTIME 
_INPOUT 
_KEEPPR 
_KILL PR 
_MALLOC 
_NAMECK 
_OPEN 
_PRNSNS 
_RENAME 
_S_PROCESS 
_SETDATE 
_SETTIME 
_SUSPEND 
_VERNUM 


FSORT 
FSST 
FSUGE 
FSUN 
FTRAPEO 
FTRAPGLE 
FTRAPNE 
FTRAPNLT 
FTRAPOGL 
FTRAPOR 
FTRAPULE 
FTRAPSF 
FTST 


_BUS_ERR 
_CHGDRV 
_COMINP 
_CONSNS 
_CURDIR 
_DISKWR 
_DUP 
_EXEC 
_FATCHK 
_FILEDATE 
_FPUTS 
_GETDATE 
_GETS 
_HENDSP 
_INTVCG 
_KEYCTRL 
_KNJCTRL 
_MALLOC2 
_NAMESTS 
_OPEN_PR 
_PSPSET 
_RMDIR 
_SEEK 
_SETENV 
_SLEEP PR 
_TIME_PR 
_WAIT 
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@ び FE ファ ンク ショ ンコ ー ル の ニー モニ ッ ク 


__ATAN _- _BTOS __CDADD _-_CDCMP 

__CDDEC _ _CDDIV __CDINC _-_CDMOD 

__CDMUL _ _CDSUB _ GDHEOE __CDTOL 

ー CST _ _CFADD __CFCMP __CFDEC 

_ _CFDIV __CFINC __CFMOD __CFMUL 

__CFSUB __CFTOD _-_CF1TOL __CFTST 

__CLDIV __CLMOD __CLMUL __CLTOD 

__@LiOE __GGOS __ で UIDIV __CUMOD 

__CUMUL _ _DABS __DADD _-_DADDONE 

_- _DCEIL __DCMP __DDIV __DDIVTWO 

_ _DFIX __DFLOOKR __DFRAC __DFREXP 

__DIEECNV _ _DLDEXP _-_DMOD _ _DMUL 

_- _DNEG __DSGN _-_DSUB __DSUBONE 

_-_DTOF _ _DTOL _-_DTOS _ DSE 

ー_ECVT _ EXP __FABS _- _FADD 

__FADDONE __FATAN __FOEIL __FCMP 

__FCOS FCVI __FDIV __FDIVTWO 

__EEGV __FEVARG _ _FBVECS _ FE 攻 P 

__FFCVT _ RE __FFLOOR __FFRAC 

_ _FFREXP _ _ENGWVT _ _FIEECNV __FLUDEXE 

_- _FLOG _- _FMOD __FMUL __FNEG 

_ _FNPI ー FI __FPOWER __FRND 

__FSGN __FSIN __FSOR __FSUB 

_ _FSUBONE __FTAN __FTOD =。RIHOL 

_ FTOS __FTST _ _FUSING __FVAL 

__GCVT _-_HTOS __IDIV __IEEDCNV 

_ _IEBFCNV _- _IMUL _ _IUSING __LDIV 

__LMOD _-_LMUL __LOG __LTOD 

こ INMOE __MOS __NPI __OTOS 

了 本 | __POWEKR _- _RAND _-_RANDOMIZE 

_- _RND __SIN __SOR _SRAND 

_-_STOB _STOD _STOF __STOH 
_STOL _ STOO _TAN __UDIV 
_UMOD UMUL __USING VAL 


20 


] 。 8 だ が だ ッ ガ DB) 


Breakpoint 
B, BC, BD, BE, BR 


プレ ー ク ポイ ント は 、rap #9 (ROM デ バッ ガ は #8) を プロ グラ ム に 埋め 込み 、 
そこ か ら 発 生 する 割り 込み を 監 愉 す る こと で 、 実 現し て いま す 。 従っ て ユー 
ザー プロ グラ ム が 、rap# 的 また は #8 を 使用 し て いる 場合 、 デ バッ グ す る こと が 
で きま せん 。 デバッグ 中 は 一 時 的 に 、 他 の trap ベ クタ を 利用 し て デバ ッ ガ と 衝 
突 し な いよ うに 、 注 意 し て くだ さい 。 


同様 に デバ ッ ガ は 次 の ベク タ を 専有 し 、 随 時 書き 換え ます 。 下 記 の ベク タ が 
示す アド レス に 、 誤 っ て プレ ー ク ポイ ント を 設置 し な いよ う 注 意 し て くだ さ 
い 。 正常 な 動作 が で き な く な る 恐れ が あり ます 。 


念 X68000 
ベク タ 番 号 ベク ター オフ セッ ト 内 容 
2 $O008 バス エラ ー 
9 $000C アド レス エラ ー 
4 $0010 不当 命令 
5 $0014 0 に よる 除算 
6 $0018 CHK 命 令 
り 4 $OO01C TRAPV 命 令 
8 $0020 特権 違反 
9 $0024 トレ ー ス 割 込 
闘 1 $007C NMI 
4 1 $00A4 TRAP #9 
@X68030 
ベク タ 番 号 ベク ター オフ セッ ト 内 容 
2 $0008 バス エラ ー 
3 $OO00C アド レス エラ ー 
4 $0010 不当 命令 
5 $0014 0 に よる 除算 
6 $0018 CHK 命 令 
7 $001C TRAPV 命 令 
9 $0024 トレ ー ス 割り 込み 
1 史 $0030 未定 義 ベ クタ 
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ベク タ 番 号 ペク ター オフ セッ ト 内 容 

1.8 $0034 コ プ ロ セッ サ プ ロ トコ 
ル 違 反 

1 4 $0038 ネ 補 マッ トラ ー 

1 5 $003C 未 初期 化 ベ クタ 

16-23 $0040 一 $005C 未定 義 ペ クタ 

2 4 $0060 スプ リア ス 割 込 

2 5~-30 $0064 一 $0078 オー トペ ベク タ 

3 $007C NMI 

4 1 $00A4 TRAP #9 

4 8(FPCP 用 ) $OOCO アン オー ダ 条 件 で の 分 
岐 ・ セ ッ ト 

4 9 $00C4 不正 確 な 結果 

5 0 $OOC8 ゼロ 除算 

5 1 $OOCC アン ダー フロ ー 

5 2 $O0DO オペ ラン ド エ ラ ー 

5 $00D4 オー バー フロ ー 

5 4 $O0D8 シグ ナリ ング NAN 

5 5 $OODC 未定 義 ベ クタ 

5 6 (PMMU 用 ) $OOEO コン フィ ギュ レー ショ 
ピス 

全 人 ダ $OOE4 不当 操作 

5 8 $OOE8 アク セス レベ ル 違 反 

5 9 一 63 $00EC 一 $00FC 未定 義 ベ クタ 

下記 の ベク タ は 16 ビ ッ ト 機 と 互換 性 を 維持 する た め 、 デ バッ ガ は 監視 し ませ 
ん 。 
8 $0020 特権 違反 


上 記 に 含ま れ な い 割 り 込み が 発生 し た 場合 、Human68k の エラ ー 処 理 が 起動 さ 
れ 、 プ ログ ラム は 強制 終了 し ます 。 


ら 2 


G [ 王 ぐ 開始 アド レス >] [< く プ レー クボ ポイ ント の アド レス フ ] 
機能 デバ ッ グ 中 の プロ グラ ム の 実行 


解 説 | G コ マン ド に よっ て 、 プ ログ ラム が 正常 に 終了 し た 場合 、 あ る い は OS が 復元 
不可 能 な エラ ー を 検出 し て 、 強 制 終 了 さ せ た 場 合 に は 、 レ ジス タ 表 示 を せ ず 
に コマ ンド 入力 に 戻り ます 。 こ と の と き 、 プ ログ ラム 自体 は 破壊 さん て いる の 
で 、R コ マン ド で 再 ロ ー ド する 必要 が あり ます 。 


また X68030 で は 、G コ マン ド 以 外 に も 、 分 岐 命令 な ど が 発生 する まで プロ グ 
ラム を 実行 する TN、UN コ マン ド が 用 意 き れ ま し た 。 


例 G コ マン ド の 使用 例 を 以下 に 示し ます 。 


ーR T.X 

PC:00133C60 USP:00111484 MSP:00112776 ISP:000082C2 SR:0000 

X:0 N:0 Z:0 V:O C:0 SFC:03 DFC:03 CACR:00000000 CAAR:DCECFFFC VBR:00000000 
HI:1 LS:O CC:1 CS:O NE:1 EQ:0 VC:1 VS:0 PL:1 MI:O GE:1 LT:O GT:1 LE:0 HS:1 LO:0 

D 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
A 00133B60 00133C6C 00110184 000FC218 00133C60 00000000 00000000 00111484 
Start: 

moveq #$00,D1 

= 


00133C60 moveq #$00,.D1 

00133C62 moveq #64,DO 

loopStart: 

00133C64 addq.l #2,D1 

00133C66 dbf DO,$00133C64.IoopStart 
00133C6A  _EXIT 


00133C6C orilb 的 00,.DO 
00133C70 ori.b  # 多 00,DO0 
00133C74 ori.b  #$00,DO0 
ーB .loopStart 
ーG 


break at 00133C64 
PC:00133C64 USP:00111484 MSP:00112776 ISP:000082C2 SR:0000 
X:0 N:0 Z:0 V:O C:0 SFC:03 DFC:03 CACR:00000000 CAAR:DCECFFFC VBR:00000000 
HI:1 LS:0 CC:1 CS:O0 NE:1 EQ:0 VC:1 VS:0 PL:1 MI:O GE:1 LT:O GT:1 LE:0 HS:1 LO:0 
D 00000064 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
A 00133B60 00133C6C 00110184 000FC218 00133C60 00000000 00000000 00111484 
loopStart: 
addq.| #2.D1 
一 圏 
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History 「race 
書 式 | 印 
トレ ー ス 履歴 の 表示 
と の コマ ンド を 実行 する まで に トレ ー ス し た 機械 語 の アド レス を 、10 個 まで 
表示 し ます 。 
また TN も し く は UN コマ ンド を 実行 し て いた 場合 に は 、 過 去 10 回 まで の 分 岐 
位置 が 表示 され ます 。 


例 HI コマ ンド の 使用 例 を 以下 に 示し ます 。 


PC:00131512 USP:0010ED74 MSP:00110066 ISP:000082C2 SR:8000 

X:0 N:0 Z:0 V:0 C:0 SFC:03 DFC:03 CACR:00000000 CAAR:DCECFFFC VBR:00000000 
HI:1 LS:0 CC:1 CS:0 NE:1 EQ:0 VC:1 VS:0 PL:1 MI:O GE:1 LT:O GT:1 LE:0 HS:1 LO:0 

D 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
A 00000000 00000000 00000000 00000000 00000000 00000000 00000000 0010ED74 


FPCR:00000000 
FPSR:00000000 
FPIAR:00000000 

move USP,A7 

ーHI 

Trace history from older. 

00131510 movea.w  D3,A3 
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1. 3 デバ ッ ガ (DB) 


ai 
し < レッ] 
メモ リ 内 容 の 逆 ア セン プル リス ト 


逆 ア セン プル リス ト の 対象 は 、 従 来 の MPU68000 ニ ー モ ニッ クコ ー ド 以外 に 
も 、MPU68030・FPCP68882・DOS コ ユール ・FE フ ァ ン クシ ョ ンコ ー ル の ニー 
モニ ッ ク コ ー ド が サポ ー ト され て いま す 。 


な お 、 逆 アセ ンプ ブル リス ト の 対象 と な る ニー モニ ッ ク が た くさ ん ある た め 、 
非常 に 複雑 な コー ド は 逆 ア セン プル 速度 が 遅く な る 場合 が あり ます 。 


XDIS コ マン ド に よっ て 、 浮 動 小数 点 イ ミディ エイ ト 値 は 、16 進 数 表記 と 10 進 
数 表記 の どちら か を 選択 で きま す 。 


例 し コマ ンド の 使用 例 を 以下 に 示し ます 。 


PC:00131512 USP:0010ED74 MSP:00110066 ISP:000082C2 SR:8000 
X:0O N:0 Z:0 V:0 C:0 SFC:03 DFC:03 CACR:00000000 CAAR:DCECFFFC VBR:00000000 
HHE1 LS:0 CC:1 CS:0 NE:1 EQ:0 VC:1 VS:0 PL:1 MEO GE:1 LT:O0 GT:1 LE:0 HS:1 LO:0 
D 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
A 00000000 00000000 00000000 00000000 00000000 00000000 00000000 0010ED74 
0 
FPCR:00000000 


0 
0 FPSR:00000000 
0 FPIAR:00000000 


move USP,A7 

ーHI 

Trace history from older. 
00131510 movea.w 
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TraceNew 
TN [= く < ア ドレ ス >] [< く カ ウン トン >] 
分 岐 す る まで の プロ グラ ム の 実行 と トレ ー ス 


X68030 の み で 実行 可能 を な を コマ ンド で す 。 
TN コ マン ド は 、 条 件 分 岐 、 リ ター ン 命 令 サブ プル ー チ ンコ ー ル 、 プ ログ ラム 
実行 に 含ま れる 割り 込み 動作 が 発生 する な どの 分 岐 が 発生 する まで プロ グラ 
ム を 実行 し 、 分 岐 後 の レ ジス タ と フラ グ の 現在 値 を すべ て 表示 し ます 。 
プロ グラ ム 実 行 フロ ー を 乱す 要因 の 発見 、 関 数 脱出 経路 の 調査 、 あ る い は 関 
数 の 値 の 評価 な ど を 、 極 め て 高速 に 行う こと が で きま す 。 
< アド レス > を 指定 し た 場合 は 、、 そ の アド レス か ら ト レー ス を 開始 し ます 。 
指定 し な い 場 合 は 、 プ ログ ラム カウ ンタ の 示す アド レス か ら ト レー ス を 開始 
双 ま 5 
ご アド レス > を 指定 する 場合 は 、 イ コー ル 記 号 ( ニ ) が 必要 と な り ま す 。 
< カウ ント > を 指定 する と 、 そ の 数 の 分 岐 が 発生 する まで 停止 し ませ ん 。 


TN コ マン ド の 使用 例 を 以下 に 示し ます 。 


ーR ccv.x 

PC:00132A3E USP:0010ED74 MSP:00110066 ISP:000082C2 SR:0000 

X:0 N:0 Z:0 V:0 C:0 SFC:03 DFC:03 CACR:00000000 CAAR:DCECFFFC VBR:00000000 

HI:1 LS:0 CC:1 CS:0 NE:1 EQ:0 VC:1 VS:0 PL:1 MIO GE:1 LT:O0 GT:1 LE:0 HS:1 LO:0 

D 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 

A 001323B0 00134FE2 0010DA74 000F9AF8 00132A3E 00000000 00000000 0010ED74 
main: 


$0040(A1),A1 :$00135022(long $43F4337B) 


PC:00132A60 USP:0013501A MSP:00110066 ISP:000082C2 SR:4000 

X:0 N:0 Z:0 V:0 C:0 SFC:03 DFC:03 CACR:00000000 CAAR:DCECFFFC VBR:00000000 

HI:1 LS:0 CC:1 CS:0 NE:1 EQ:0 VC:1 VS:0 PL:1 MI:O0 GE:1 LT:0 GT:1 LE:0 HS:1 LO:0 

D 00000158 00000000 00000000 00000000 00000000 00000000 00000000 00000000 

A 00133BAF 001346C9 0010DA74 000F9AF8 00132A3E 00000000 00000000 0013501A 

move.b (AO) 十 ,(A1) 十 :$001346C9(byte $00) 

ーR CcV.X 

PC:00132A3E USP:0010ED74 MSP:00110066 ISP:000082C2 SR:0000 

X:0 N:0 Z:0 V:0 C:0 SFC:03 DFC:03 CACR:00000000 CAAR:DCECFFFC VBR:00000000 

HI1 LS:0 CC:1 CS:0 NE:1 EQ:0 VC:1 VS:0 PL:1 MI:O GE:1 LT:0 GT:1 LE:0 HS:1 LO:0 

D 00000158 00000000 00000000 00000000 00000000 00000000 00000000 00000000 

A 001323B0 00134FE2 0010DA74 000F9AF8 00132A3E 00000000 00000000 0010ED74 
main 
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1 。 3 デバ ッ ガ (DB 


$0040(A1),A1 :$00135022(long $43F4337B) 


PC:00132A42 USP:0010ED74 MSP:00110066 ISP:000082C2 SR:8000 

X:O N:0 Z:0 V:0 C:0 SFC:03 DFC:03 CACR:00000000 CAAR:DCECFFFC VBR:00000000 
HI:1 LS:0 CC:1 CS:0 NE:1 EQ:0 VC:1 VS:0 PL:1 MI:O GE:1 LT:O GT:1 LE:0 HS:1 LO:0 

D 00000158 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
A 001323B0 00135022 0010DA74 000F9AF8 00132A3E 00000000 00000000 0010ED74 
movea.|  A1.AZ7 

一 圏 
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Untrace New 
UN [< アド レス >] [< カウ ント >] 
分 岐 する まで の プロ グラ ム の 実行 と 表示 な し トレ ー ス 


X68030 の み で 実行 可能 な コマ ンド で す 。 


UN コマ ンド は 、TN コ マン ド と ほぼ 同じ で す が 、 プ ログ ラム が 停止 する まで は 
レジ スタ と フラ グ の 値 を 表示 し ませ ん 。 

< カウ ント > を 指定 し て 要 数 の 分 岐 を トレ ー ス する 際 、 途 中 で トレ ー ス 表示 
が 必要 な い 場 合 に 、 こ の UN コマ ンド を 使用 し ます 。 


例 UN コマ ンド の 使用 例 を 以下 に 示し ます 。 


ーーR CCV.X 
PC:00132A3E USP:0010ED74 MSP:00110066 ISP:000082C2 SR:0000 
X:0 N:0 Z:0 V:0 C:0 SFC:03 DFC:03 CACR:00000000 CAAR:DCECFFFC VBR:00000000 
HI:1 LS:0 CC:1 CS:0 NE:1 EQ:0 VC:1 VS:0 PL:1 MI:O GE:1 LT:0 GT:1 LE:0 HS:1 LO:O0 
D 00000158 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
A 001323B0 00134FE2 0010DA74 000F9AF8 00132A3E 00000000 00000000 0010ED74 
_ ain: 
lea $0040(A1),A1 :$00135022(long $43F4337B) 
ーUN 
PC:00132A60 USP:0013501A MSP:00110066 ISP:000082C2 SR:4000 
X:0 N:0 Z:0 V:0 C:0 SFC:03 DFC:03 CACR:00000000 CAAR:DCECFFFC VBR:00000000 
HI:1 LS:0 CC:1 CS:0 NE:1 EQ:0 VC:1 VS:0 PL:1 MI:O GE:1 LT:0 GT:1 LE:O HS:1 LO:0 
D 00000158 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
A 00133BAF 001346C9 0010DA74 000F9AF8 00132A3E 00000000 00000000 0013501A 
move.b (AO) 十 ,(A1) 十 :$001346C9(byte $00) 
ーR coV.x 
PC:00132A3E USP:0010ED74 MSP:00110066 ISP:000082C2 SR:0000 
X:0 N:0 Z:0 V:0 C:0 SFC:03 DFC:03 CACR:00000000 CAAR:DCECFFFC VBR:00000000 
HI:1 LS:0 CC:1 CS:0 NE:1 EQ:0 VC:1 VS:0 PL:1 MI:O GE:1 LT:0 GT:1 LE:O HS:1 LO:0 
D 00000158 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
A 001323B0 00134FE2 0010DA74 000F9AF8 00132A3E 00000000 00000000 0010ED74 
_ rmain: 

$0040(A1),A1 :$00135022(long $43F4337B) 
= 
PC:00132A42 USP:0010ED74 MSP:00110066 ISP:000082C2 SR:8000 
X:0 N:0 Z:0 V:0 C:0 SFC:03 DFC:03 CACR:00000000 CAAR:DCECFFFC VBR:00000000 
HI:1 LS:0 CC:1 CS:0 NE:1 EQ:0 VC:1 VS:0 PL:1 MI:O GE:1 LT:0 GT:1 LE:0 HS:1 LO:0 
D 00000158 00000000 00000000 00000000 00000000 00000000 00000000 00000000 


1。 3 デパ ッ ガ DB) 


A 001323B0 00135022 0010DA74 000F9AF8 00132A3E 00000000 00000000 0010ED74 


movea.|  A1.AZ 
| 


29 


第 1 章 X68030 対 応 ツ ー ル 


FDisplay Reglsterーーーーーーー ザ プイ 
全 レ ジス タ の 内 容 の 表示 


解 説 | X コ マン ド は 、 レ ジス タ と フラ グ の 内 容 を すべ て 表示 し ます 。 な お 実装 され て 


いる MPU の 種類 、 個 数 に 応じ て 表示 され る レジ スタ が 変わ り ま す 。 ま た レジ 
スタ に よっ て は 、10 進 数 、 2 進数 、10 進 数 浮動 小数 点 で 表示 され ます 。 


例 X コ マン ド の 使用 例 と 表示 形式 を 以下 に 示し ます 。 


@X68000 の 場合 


ーー うく 

PC:00151F50 USP:0012F7B4 SSP:0011B3DE SR:0000 X:0 N:0 Z:0 V:0 C:O 

HI:1 LS:0 CC:1 CS:0 NE:1 EQ:0 VC:1 VS:0 PL:1 MI:O GE:1 LT:0 GT:1 LE:0 HS:1 LO:0 
D 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
A 00000000 00000000 00000000 00000000 00000000 00000000 00000000 0012F7B4 
ori.b#00,D0 

| 


@X68030 の 場合 


ー メ X 
PC:00132A42 USP:0010ED74 MSP:00110066 ISP:000082C2 SR:8000 
X:0 N:0Z:0 V:0 C:0 SFC:03 DFC:03 CACR:00000000 CAAR:DCECFFFC VBR:00000000 
HI:1 LS:0 CC:1 CS:0 NE:1 EQ:0 VC:1 VS:0 PL:1 MI:O GE:1 LT:0 GT:1 LE:0 HS:1 LO:0 
D 00000158 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
A 001323B0 00135022 0010DA74 000F9AF8 00132A3E 00000000 00000000 0010ED74 
FP 0 0 

0 FPCR:00000000 

0 FPSR:00000000 

0 FPIAR:00000000 
movea.| A1.AZ 
| 
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PC 
2 USP 
3 SSP 
4 MSP 
5 ISP 
6 SR 
7 X 
8N 
9Z 
10V 
11C 
12SFC 


13DFC 
14CACR 
15CAAR 
16VBR 
17 


18D 
19A 
20FP 
21FPCR 
22FPSR 
23FPIAR 


1。3 デバ パッ ガ DB 


プロ グラ ムカ ウン タ 

ユー ザー ズ タ ッ クボ イシ ンタ 

シス テム スタ ッ ク ポ イン タ 

マス タス タッ ク ポ イン タ 

割込み スタ ッ ク ポ イン タ 

ステ ー タ スレ ジス タ 

エタ ステ ンド フラ グ (ステ ー タ スレ ジス タ の ビ ピット 4) 
ネガ ティ ブフ ラグ (ステ ー タ スレ ジス タ の ビッ ト 3) 
ゼロ フラ グ (ステ ー タ スレ ジス タ の ビッ ト 2) 

オー バー フロ ー フ ラグ (ステ ー タ スレ ジス タ の ビッ ト 1 ) 
キャ リー フラ グ (ステ ー タ スレ ジス タ の ビッ ト 0) 
ジー スラ ファ ンク ジョ シコ ー ド レジ スタ 

デス ティ ネー ショ ンジ ファ シク ショ ンコ ー ド レジ スタ 
キャ ッシュ 制御 レジ スタ 

キャ ッシュ アド レス レジ スタ 

ベク タベース レジ スタ 

分 岐 命令 用 条件 フラ グ 
(HLLS,CC,CS,NE,EQ,VC,VS,PL,MIIGE,LT,GT,LE,HS,LO) 
デー タレ ジス タ (d0 一 d7) 

アド レス レジ スタ (a0 一 a7) 

浮動 小数 点 デ ー タ レジ スタ (FP0 一 FP7) 

浮動 小数 点 コ ント ロー ルレ ジス タ 

浮動 小数 点 ス テー タス レジ スタ 

浮動 小数 点 命令 アド レス レジ スタ 
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999Ner Bldg9ーーーー ニ ーー ニー 
X く レ ジス タッ > [. く デー タン] 

レジ スタ の 内 容 の 変更 

X コ マン ド は 、 指 定 さ れ た レジ スタ の 内 容 を 変更 し ます 。 


指定 可能 な レジ スタ 名 は 以下 の 通り で す 。 


価 X68000 の 場合 
dO 一 d7,a0 一 a7, 
SSD,USD,SD,ST,CCT,DC 


@X68030 の 場合 
d0 一 d7,a0 一 a7, 
SSD,USD,SD,ST,CCT,DC, 
msD,iSD,Sfc,dfc,Cacr,Ca4r,Vbr 


人 @FPCP68882 を 付け た X68030 の 場合 
fp0 一 fp7,fpcr,fpsr,fpiar 


< く レ ジス タ > ン に < デー タッ > を 代入 し ます 。 く デー タッ > に は 、 整 数 レジ スタ で 
あれ ば 式 が 利用 で きま す 。 な お 2 進数 で 指定 する レジ スタ 、 あ る い は 10 進 数 
浮動 小数 点 で 指定 する レジ スタ に は 、 式 は 使用 する こと が で きま せん 。 


< デー タッ > を 指定 し な い 場 合 は 、 レ ジス タ 名 、 現 在 値 を 表示 し 、 入 力 待ち に 
な り ま す の で 、 新 し い 値 を 入力 し 、 リ ター ン キ ー を 押し て くだ さい 。 


例 X コ マン ド の 使用 例 を 以下 に 示し ます 。 


PC:00132A44 USP:00135022 MSP:00110066 ISP:000082C2 SR:8000 

X:0 N:0 Z:0 V:0 C:0 SFC:03 DFC:03 CACR:00000000 CAAR:DCECFFFC VBR:00000000 
HI:1 LS:0 CC:1 CS:0 NE:1 EQ:0 VC:1 VS:0 PL:1 MI:O GE:1 LT:0 GT:1 LE:0 HS:1 LO:0 

D 00000158 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
A 001323B0 00135022 0010DA74 000F9AF8 00132A3E 00000000 00000000 00135022 


FP 0 0 

0 0 FPCR:00000000 

0 0 FPSR:00000000 

0 0 FPIAR:00000000 
lea $0010(AO),A0 汐 001323CO(long $000F9AF8) 
ーXPC 


1 3 デパ ッ ガ DD 所 


PC:00132A44 王 00132B00 

ーT 

PC:00132B06 USP:00135022 MSP:00110066 ISP:000082C2 SR.8009 

X:0 N:1 Z:0 V:0 C:1 SFC:03 DFC:03 CACR:00000000 CAAR:DCECFFFC VBR:00000000 


HI:O LS:1 CC:0 CS:1 NE:1 EQ:0 VC:1 VS:0 PL:0 MI:1 GE:0 LT:1 GT:O0 LE:1 HS:0 LO:1 

D 00000158 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
A 001323B0 00135022 0010DA74 000F9AF8 00132A3E 00000000 00000000 00135022 
bcc.S $00132B0E 

一 陣 
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Interrupt Mask Level 一 ーーーーーーー 


書 式 | 錠 [< 割り 込み レベ ルッ >] 


機 能 | 割り 込み レベ ル の 変更 


解 説 | MPU の 割り 込み レベ ル を 0 一 7 の いずれ か に 変更 し ます 。 7 を 指定 し た 場合 
に は 、 割 り 込 み 禁 止 状態 に な り ま す 。 


例 XI コ マン ド の 使用 例 を 以下 に 示し ます 。 


三次 | 


interrupt mask levelis 0 ,newlevelis ? 7 
| 
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1。 3 デバ ッ カ 0DB9 


Memory Display Mode 
書 式 | XM 
機 能 | メモ リ 内 容 表 示 モ ー ド の 切り 替え 


アド レス を 参照 する 命令 を 表示 する 際 に 、 参 照 す る アド レス の メモ リ 内 容 を 
表示 する か 否 か を 切り 苦 え ます 。 


例 XM コ マン ド の 使用 例 を 以下 に 示 し ます 。 


ーXM 

Memory display mode disable. 

一 漁 

PC:001B86CA USP:00195F74 MSP:00197266 ISP:000082C2 SR:8000 

X:0 N:0 Z:0 V:0 C:0 SFC:03 DFC:03 CACR:00002101 CAAR:DCECFFFC VBR:00000000 
HI:1 LS:0 CC:1 CS:0 NE:1 EQ:0 VC:1 VS:0 PL:1 MI:O GE:1 LT:0 GT:1 LE:0 HS:1 LO:0 

D 00000001 00000000 00000000 00000000 00000000 00000000 00000000 0000000F 
A 00000000 00000001 00000001 00000000 00000000 00000000 00000000 00195F74 
tst.b(A1) 

ーXM 

Memory display mode enable. 

ーX 

PC:001B86CA USP:00195F74 MSP:00197266 ISP:000082C2 SR:8000 

X:0 N:0 Z:0 V:0 C:0 SFC:03 DFC:03 CACR:00002101 CAAR:DCECFFFC VBR:00000000 
HI:1 LS:0 CC:1 CS:0 NE:1 EQ:0 VC:1 VS:0 PL:1 MI:O GE:1 LT:0 GT:1 LE:0 HS:1 LO:0 

D 00000001 00000000 00000000 00000000 00000000 00000000 00000000 0000000F 
A 00000000 00000001 00000001 00000000 00000000 00000000 00000000 00195F74 
tst.b(A1) 00000001(byte $FF) 

一 田 
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Floating Point Co-Processor 一 一 一 - 
XFPcp 
浮動 小数 点 コ プロ セッ サ (FPCP) の 有効 ・ 無 効 の 切り 替え 


解 語 FPCP を 内 蔵 し て いる X68030 の み で 実行 可能 な コマ ンド で す 。 
有効 状態 で は 、FPCP の 全 レ ジス タ が レジ スタ リス ト に 加え られ 、 デ バッ ガ の 
監視 下 に 入り ます 。 無効 状態 で は 、 デ バッ ガ の FPCP へ の アク セス は 一 切 禁 止 
され 、 監 視 下 に も 入り ませ ん 。 
な お この コマ ンド は 、 ユ ー ザ ー プ ログ ラム が FPCP に アク セス する の を 禁止 す 
る も の で は あり ませ ん 。 


例 XFPCP コ マン ド の 使用 例 を 以下 に 示し ます 。 


XFPCP 
FPCP disable. 
レー の < 
PC:00132B06 USP:00135022 MSP:00110066 ISP:000082C2 SR:8709 
X:0 N:1 Z:0 V:0 C:1 SFC:03 DFC:03 CACR:00000000 CAAR:DCECFFFC VBR:00000000 
HI:0 LS:1 CC:0 CS:1 NE:1 EQ:0 VC:1 VS:0 PL:O MI:1 GE:0 LT:1 GT:0 LE:1 HS:0 LO:1 
D 00000158 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
A 001323B0 00135022 0010DA74 000F9AF8 00132A3E 00000000 00000000 00135022 
bcc.s $00132BOE 
ーXFPCP 
FPCP enable. 
= 
PC:00132B06 USP:00135022 MSP:00110066 ISP:000082C2 SR:8709 
X:0 N:1 Z:0 V:0 C:1 SFC:03 DFC:03 CACR:00000000 CAAR:DCECFFFC VBR:00000000 
HI:O0 LS:1 CC:0 CS:1 NE:1 EQ:0 VC:1 VS:0 PL:O ME:1 GE:0 LT:1 GT:0 LE:1 HS:0 LO:1 
D 00000158 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
A 001323B0 00135022 0010DA74 000F9AF8 00132A3E 00000000 00000000 00135022 
FP 0 0 

0 FPCR:00000000 

0 FPSR:00000000 

0 FPIAR:00000000 

$00132BOE 
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1。 3 デパ バッカ [9 


FPCP Disassemble Parameter Translate 


書 式 | xDiS 
逆 ア セン プル リス ト 中 の 浮動 小数 点 デ ー タ の 表示 方 法 の 切り 奉 え 


有効 状態 で は 、 逆 アセ ンプ ルリ スト 中 に ある 浮動 小数 点 値 が 、10 進 数 浮動 小 
数 点 で 表現 され ます 。 無 効 状態 で は 16 進 数 で 表現 され ます 。 


例 XDIS コ マン ド の 使用 例 を 以下 に 示し ます 。 


ーXDIS 

FPCP disassemble parameter translate disable. 

ーL . main 

_ main: 
000C4E5C fmove.d # 准 4059000000000000,FP0 
000C4E68 fadd.d 約 400921FB54524550,FP0 
000C4E74 lea  $000C6E96.1A1 
000C4E7A move.W #0159,D0 
000C4E7E move.b (A0) 十 ,(A1) 十 
000C4E80 dbf DO.$000C4E7E 
000C4E84 clr.D (A1) 
000C4E86 clr.| 一 (A7) 

ーXDIS 

FPCP disassemble parameter translate enable. 

ーL . main 

_ main: 


000C4E5C fmove.d  #100,FPO 


000C4E68 
000C4E74 
000C4E7A 
000C4E7E 
000C4E80 
000C4E84 
000C4E86 
一 陣 


fadd.d# 3.1415926540000001,FP0 
lea  $000C6E96.1A1 

move.w #$0159,D0 

move.b (A0) 十 ,(A1) 十 

dbf DO.$000C4E7E 

clr.b (A1) 

clr.| 一 (A7) 
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第 1 章 X68030 対 応 ツ ー ル 


rFPCP Reglster Dump Iranslate- ニ 一 一 一 


XFX 
レジ スタ 値 の 澤 動 小数 点 表示 方 法 の 切り 巻 え 


解 説 | 浮動 小数 点 コ プロ セッ サ (FPCP) 内 蔵 の X68030 の み で 実行 可能 な コマ ンド で 
す 。 有効 状態 で は 、 レ ジス タリ スト 中 に ある 浮動 小数 点 値 が 、10 進 数 浮動 小 
数 点 で 表現 され ます 。 無効 状態 で は 16 進 数 で 表現 され ます 。 


例 XFX コマ ンド の 使用 例 を 以下 に 示し ます 。 


ー メ XFX 
FPCP register dump translate disable. 
ーX 
PC:00132B06 USP:00135022 MSP:00110066 ISP:000082C2 SR:8709 
X:0 N:1 Z:0 V:0 C:1 SFC:03 DFC:03 CACR:00000000 CAAR:DCECFFFC VBR:00000000 
HI:O LS:1 CC:0 CS:1 NE:1 EQ:0 VC:1 VS:0 PL:O MI:1 GE:0 LT:1 GT:0 LE:1 HS:0 LO:1 
D 00000158 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
A 001323BO0 00135022 0010DA74 000F9AF8 00132A3E 00000000 00000000 00135022 
FP 000000000000000000000000 000000000000000000000000 
000000000000000000000000 000000000000000000000000 FPCR:00000000 
000000000000000000000000 000000000000000000000000 FPSR:00000000 
000000000000000000000000 000000000000000000000000 FPIAR:00000000 
bcc.S $00132B0E 
ー メ XFX 
FPCP register dump translate enable. 
= 
PC:00132B06 USP:00135022 MSP:00110066 ISP:000082C2 SR:8709 
X:0 N:1 Z:0 V:0 C:1 SFC:03 DFC:03 CACR:00000000 CAAR:DCECFFFC VBR:00000000 
HI:O LS:1 CC:0 CS:1 NE:1 EQ:0 VC:1 VS:0 PL:O0 MI:1 GE:0 LT:1 GT:O LE:1 HS:0 LO:1 
D 00000158 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
A 001323B0 00135022 0010DA74 000F9AF8 00132A3E 00000000 00000000 00135022 
FP 0 0 
0 FPCR:00000000 
0 FPSR:00000000 
0 FPIAR:00000000 
$00132BOE 
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1 3 デバ パン ガ ] 本 有り 


rFPCP Register Dumpーーーーーーーー 
xrp 


機 能 | レジ スタ リス ト 表 示 の 際 の フロ ー テ ィング レジ スタ の 表示 切り 替え 


解 計 浮動 小数 点 コ プロ セッ サ (FPCP) を 内 蔵 し て いる X68030 の み で 実行 可能 な コ 
マン ド で す 。 有効 状態 で は 、 レ ジス タリ スト 中 に フロ ー テ ィング レジ スタ 
(F P) が 表示 され ます 。 無効 状態 で は 表示 され ませ ん 。 


例 XFP コマ ンド の 使用 例 を 以下 に 示し ます 。 


一 XFP 
FPCP register durmp disable. 
ー メ X 
PC:00132B06 USP:00135022 MSP:00110066 ISP:000082C2 SR:8709 
X:0 N:1 Z:0 V:0 C:1 SFC:03 DFC:03 CACR:00000000 CAAR:DCECFFFC VBR:00000000 
HI:0 LS:1 CC:0 CS:1 NE:1 EQ:0 VC:1 VS:0 PL:O ME1 GE:0 LT:1 GT:0 LE:1 HS:0 LO:1 
D 00000158 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
A 001323B0 00135022 0010DA74 000F9AF8 00132A3E 00000000 00000000 00135022 
bcc.S $00132BOE 
一 XFP 
FPCP register dump enable. 
ーX 
PC:00132B06 USP:00135022 MSP:00110066 ISP:000082C2 SR:8709 
X:0 N:1 Z:0 V:O C:1 SFC:03 DFC:03 CACR:00000000 CAAR:DCECFFFC VBR:00000000 
HI:0 LS:1 CC:0 CS:1 NE:1 EQ:0 VC:1 VS:0 PL:O ME1 GE:0 LT:1 GT:0 LE:1 HS:0 LO:1 
D 00000158 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
A 001323B0 00135022 0010DA74 000F9AF8 00132A3E 00000000 00000000 00135022 
FP 0 0 
0 0 FPCR:00000000 
0 0 FPSR:00000000 
0 0 FPIAR:00000000 
bcc.S $00132BOE 
一 圏 
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ソー スコ ー ド デバ ッ ガ (SCD) 


ここ で は 、 ソ ー ス コー ド デ バ ッ ガ SCDver.3.0 で 機能 拡張 され た コマ ンド に つい て 説明 し 
ます 。 

基本 的 に 、 デ バッ ガ と 同様 の 拡張 と な っ て いま す の で 、 詳 し く は 「1.3 デバ ッ ガ 
(DB) 」 を ご 参照 くだ さい 。 


@ 機 能 が 拡張 され た コマ ンド 
A 
AN 
B,BC,BD,BE.BR 


人 @ 追 加 さ れ た コマ ンド 
XI 
XM 
XFPCP 
XDIS 
XFX 


SYNK 


FASTIO.X.FASTOPEN.X.JFASTSEEK.X へ の キャ ッシュ の フラ ッシュ な ど を 制 
御 し ます 。 


SYNC [オプ ショ ン ] 


SYNC コマ ンド は FASTIO、FASTOPEN、FASTSEEK コ マン ド で の キャ ッシュ 
状況 を 制御 する た め に 使用 で きま す 。 

この コマ ンド は 、XC シ ステ ム デ ィ ス ク 1 の SYS ディ レク トリ の 中 に 用 意 さ れ 
て いま す 。 


ウ . 


3/ 


逐次 フラ ッシュ を 行う 

状況 を 表示 する 

フラ ッシュ は SYNC.X の み で 行え る 様 に する 

イジ ェクト 可能 な ドラ イブ の み FFLUSH で フラ ッシュ を 行う 
FFLUSH で フラ ッシュ を 行う 

遅延 書 込 を 許可 する 

遅延 書 込 を 禁止 する 

キャ ッシュ を ロッ ク す る 

キャ ッシュ の ロッ ク を 解除 する 

IOCS レ ベル の アク セス 違反 で エラ ー ハ ンド ラ を 起動 する 
IOCS レ ベル の アク セス 違反 で フラ ッシュ を 行う 


省略 逐次 フラ ッシュ を 行う 


FASTIO.XFASTOPEN.X,FASTSEEK.X の いずれ か が 常駐 し て いな いと 、 こ の 
コマ ンド を 使う こと は で きま せん 。 
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時 9 タ ょ に で で ロー エ そ nATTEAR XPROTSKtYGRSA | 百 処 」 


だ 中 1 】 * すま 和 
し まり 6 3 % EE 
人 - = | で で ャ 1 の MY あ : 補 幸 | 
す * メ に 』 で e 
1 っ 人 陸 
和 電 L 
きま 『 
9 ャ 
4 2 さ 
』 1 ) で 拓 : 


Human68k ver.3.0 
ASKG68K ver.3.0 
OPMDRV3 


Human68K ver.3.0 


ここ と で は 、Human68k ver.3.0 の 特長 に つい て 説明 し ます 。 


CPU 種類 の 判別 


起動 時 、Human68k は CPU の 種類 を 判別 し て 、 ス タッ ク フ レ ー ム の 取り だ し 位置 を 調整 し 
re 

また MPU68000 以 外 の CPU の 場合 、 特 権 違反 $ も DOS コー ル の 入り 口 と し て 登録 し 、 
MOVE from SR 命令 に よる 特権 違反 が お きた 場合 は 、Move from CCR 命 令 に 書き 換え 再 
実行 し ます 。 


CONFIG フ ァイル 機能 の 充実 


CONFIG.SYS を 自由 に 変更 し て 起動 し た り 、 色 々 な CONFIG.SYS を 選択 し て 起動 し 
た り で きる よう に 、CONFIG.SYS に "EXCONFIGprogram parameter" で 指定 で きる 
CONFIG.SYS 変 更 プ ログ ラム 起動 機能 が 追加 され まし た 。 こ の 機能 を 利用 し た プロ 
グラ ム と し て CONFIGED. 双 が 提供 さき れ て いま す 。 
これ は 、FEILES, BUFFERS, LASTDRIVE, SCSIDEV, EXCONFIG 以 外 の CONFIG.SYS 
の 内 容 を 起動 中 に 追加 ・ 変 更 ・ 削 除 で きる プロ グラ ム で す 。 こ の プロ グラ ム は ユー 
ザー が 作成 する こと も で きま す 。 そ の 場合 は 、 以 下 の 仕様 に 基づい て 作成 し て くだ 
さい 。 


人 @Human68k は CONFIG.SYS を 読み 、SCSIDEV, FILES, BUFFERS, LASTDRIVE を 処 
理 し 、EXCONFIG で 指定 さて ん た プロ グラ ム を 実行 し ます 。 こ の と き 環 境 エ リア は 
64 バ イト 確保 ほれ 、 以 下 の 指 定 の み 登 録 さ れ ま す 。 

PATH ニ = ニ \:\SYS:\BIN:\BASIC2:\ETC:\SHELL 


⑱ プ ログ ラム は パラ メー タ を 解析 し て 、 以 下 の よ うに 処理 を 実行 し 、 終 了 し て くだ 
さい 。 
1) カ レン ト の CONFIG.SYS の 内 容 を 表示 する 。 
2) ど れ を 登録 し 、 ど れ を 登録 し な いか を 選択 決定 し 、 内 容 修 正す る 。 
3) 修 正 し た も の を カレ ント の CONFIG.TMP と し て 書き 込む 。 
4 終了 コー ド を セッ ト し て 終了 する 。 


終了 コー ド が 0 の 場合 は 、Human68k は CONFIG.TMP を 使っ て この 後 の 起動 処理 を 行 
いま す 。 終了 コー ド が 0 以外 な ら ば 、 そ の まま CONFIG.SYS を 使っ て 起動 処理 を 行 
いま す 。 


また 、EXCONFIG 三 COMMAND と 指定 する と 、 デ バイ ス ド ラ イ バ 登 録 前 に 
COMMAND.X を 使用 で きま す の で 、CD コ マン ド で カレ ント ディ レク トリ を 移動 し 
て EXIT す る だ け で 、 そ の ディ レク トリ 内 の CONFIG.TMP と AUTOEXEC.BAT で 起動 
で きる よう に な り ま す 。 
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2. 1 Human68K ver.3.0 


この プロ グラ ム は デバ イス ドラ イ バ 組 み 込 み 前 に 起動 きれ ます の で 、FLOAT? メ を 必 
要 と する よう な C 言 語 な ど で 作 成 さ れ た プロ グラ ム は その まま で は 起動 で きま せん 。 
EXCONFIG 実 行 前 に 、 必 要 な デバ イス ドラ イ バ が 登録 され て いる 必要 が あり ます 。 
と の よう な と き は 、 次 の 様 に し て デバ イス ドラ イ バ を 登録 し て くだ さい 。 


HUMAN.SYS に デバ イス ドラ イ バ を BIND す る こと に より 、SCSIDEV の 登録 後 、 
EXCONFIG の 実行 前 に 、 デ バイ ス ド ラ イ バ と し て 登録 する こと が で きま す 。 
EXCONFIG の 対象 外 ・ あ る い は EXCONFIG 実 行 に 際 し て 登録 済み で ある べき デバ イ 
ス ドラ イ バ は 、BIND す る こと に より 自動 登録 で きま す 。 

た だ し 、BIND し た デバ イス ドラ イ バ に は 、 初 期 化 時 の パラ メー タ 文 字 列 を 与え る こ 
と が で きま せん (内 部 の "文字 列 の ポイ ンタ が 与え られ る ) 。 

つま り 、 パ ラメ ー タ 指定 が 必要 で ある ドラ イ バ を 登録 する こと は で きま せん 。 
また 、 こ の プロ グラ ム は 必ず exit (exi2) で 終了 する 必要 が あり ます 。keeppr で 常駐 
し た 場合 は 、 そ の 時 点 で エラ ー 表 示し て 停止 し ます 。 こ と の よう な プロ グラ ム を 
EXCONFIG に 設定 され た 場合 は 、 別 の ドラ イブ か ら 再 起動 し て 、CONFIG.SYS を 修 
IEI じ GS だ きい め 。 


CONFIG.SYS に FFLUSHON/OFF 指 定 が 、 ま た DOS コ ー ル と し て ffush_set が 追加 さ 
れ 、fflush コ ー ル の 有効 ・ 無 効 が 設定 で きる よう に な り ま し た 。 
これ は 、FASTIO.X が C 言 語 で か か れ た プロ グラ ム に 対し て 、 あ まり 有効 で な いた め 
Co 
これ に より 、ctrl 十 c や fflush コ ー ル 実行 で は バッ ファ の フラ ッシュ を 行わ ず 、STOP 
キー を 押し た 場合 の み フ ラッ シュ する よう に で きま す 。 


CONEFIG.SYS に DIRSCH 王 ON/OFF 指 定 が 追加 きれ まし た 。 また 、create コ ー ル の 
際 、 引 数 の ATR の bit 15 を ON する こと に より 、 フ ァイル 検索 し な いで 新規 作成 する 
こと が 可能 と な り ま し た 。 

DIRSCH= ニ ON の と き (デフ ォ ル ト 状 態 ) は 、 フ ァイル 検索 や 新規 作成 時 に 以前 の 続 
きか ら 検 索 す る よう に な り ま す 。 
DIRSCH= ニ OFF で は 、 従 来 通り 必ず 先頭 か ら 検索 し ます 。 


凡 還 FD か ら 起 動 し た 場合 | ど だ に も 、 デ バイ ス ド ラ イ バ (SCSIDRV.SYS) の 登録 なし に 、 
SCSI ド ライ バ が 登録 で きる よう に 、CONFIG.SYS に "SCSIDEV ニ ON/OFF" の キー 
ワー ド を 記述 で きる よう に な り ま し た 。 

SCSIDEV=DN の と き (デフ ォ ル ト 状 態 ) は 、ROM 内 の SCSI デ バイ ス ド ラ イ バ が 登 
録 き まれ ます 。 

SCSIDEV=OFF と 指定 され て いる 場合 は 、SCSI ド ライ バ は 登録 され ませ ん 。 

な お この 機能 が 有効 と な る の は 、SCSI イ ンタ ー フ ェ イ ス を 内 蔵 し た 機種 も し く は 、 
SCSI ボ ー ド を 内 蔵 し て いる と きのみ で す 。 
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第 2 章 バー ジョ ン 3.0 シス テム 


ディ スク 処理 の 改善 


プロ ッ ク デ バイ ス ド ラ イ バ の コマ ンド コー ド 2 が 追加 され 、BPB の 再 構築 が 可能 と な り 
まし た 。 こ れ に と も な い Human68k ver.3.0 で は 2HD タ イプ (1024 バ イト ネ 8 玉 2※77) と 
2HC タ イプ (312 バ イト *15 玉 2*80) を 自動 判別 で きる よう に な り ま し た 。 また 追加 で 
プロ ッ ク デ バイ ス ド ラ イ バ を 登録 する こと に より 、IOCS コ ー ル で 他 の ディ スク タイ プ も 
サポート で きる よう に な り ま し た 。 

"FDDEVICE.X" は この 機能 を 利用 し て 、2DD タ イプ が 認識 で きる よう に な っ て いま す 。 
Human68k は 、 デ ィ ス ク が 交換 され た か どう か を チェ ッ ク し た あと 、 交 換 さ れ た 場合 は コ 
マン ドコ ー ド 2 を デバ イス ドラ イ バ に 発行 し 、 そ の ドラ イプ の 新 BPB を 得 て DPB を 変更 
し ます 。 


以下 に コマ ンド コー ド 2 に 関す る 詳細 を 説明 し ます 。 そ の 他 の コマ ンド コー ド に つい て 
は 、 プ ログ ラマ ー ズ マニ ュ ア ル の 「6.6 ブロック デバ イス ドライ バ | を 、 ご 参照 くだ さ 
5 


人 @ デ ィ ス ク 交 換 処 理 (Build BPB) 
コマ ンド コー ド = テ 2 
サリ サ み エス トペ ヘッダ 


26 (定数 ) 

ユニ ッ ト 番 号 

コマ ンド コー ド (2) COMCOD 
エラ ー コ ー ド (low) ERRLOW 
エラ ー コ ー ド (high) ERRHIGH 


未 使用 


メデ ィ ア バイ ト DISKID 


未 使用 


BPB の ポイ ンタ アド レス を 返す ワー ク 


ユニ ッ ト 番 号 で 指定 され た ドラ イブ を 調べ 、 新 た な BPB を 作成 し て ドラ イ バ 内 の BPBTBL 
の 一 部 を 書き 直し 、 そ の ポイ ンタ を BPBPOI に セッ ト し て 、 エ ラー コー ド 0 で Human68k に 
戻り ます 。 

BPB の 修正 が 不要 な ドラ イ バ は 、 エ ラー で 戻る か 、BPBPOI を 書き 直さ な いで 戻っ て くだ 
さい 。 
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2. 1 Human68K ver.3.0 


な お 、BPB の ポイ ンタ アド レス (BPBPOI に セッ ト す る 値 ) は 、 次 の BPBTBL の 値 で あっ て 
BPBADR そ の も の で は な い の で 注意 し て くだ さい 。 


BPBTBL: 
DC.L BPBADKR 


BPB は 、 以 下 の 構 造 を し て いま す 。 


BPBADR: 

BPBSSZ: DC.W1024 * 1 セク タ あ た り の バイ ト 数 (128,256,512,1024..…32768) 
BPBCLM: DC.B 1 *] ク ラス タ あ た り の セク タ 数 (1.2.4,8,16,32.64,128) 
BPBFTC: DC.B 2 *FAT 領 域 の 個数 (1.2) 

BPBFTS: DC.W 1 * 予 約 領域 の セク タ 数 (65535 以 下 ) 

BPBDRC: DC.W 192 * ル ー ト ディ レク トリ に は いる ファ イル 数 (2048 以 下 ) 
BPBMAX: DC.W 8* ネ 77*2  * 全 領域 の セク タ 数 (0 の 場合 は BPB_MX が 有効 ) 
BPBMID: DC.B $FE * メ ディ ア 識 別 コ ー ド ($FE,$FS,$F9) 

BPBFSZ: DC.B 2 * ] 個 の FAT 領域 に 使用 する セク タ 数 (128 以 下 ) 
BPB_MX: DCL 0 * 全 領域 の セク タ 数 (BPBMAX が 0 の と きのみ 有効 ) 
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第 2 章 バー ジョ ン 3.0 シス テム 


DOS コ ー ル の 拡張 


以下 の 様 に DOS コ ー ル が 追加 変更 され て いま す 。 詳細 に つい て は 「3.1 拡張 DOS 
コー ル ラ イブ ラリ | 「4.1 拡張 DOS コ ー ル | を 参照 し て くだ さい 。 


訓 FFS0 か ら $FF7F の DOS コ ユール は 、MC68EC030 で は スー パー バイ ザー モー ド で コー 
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ル す る と バス エラ ー が 発生 する こと が ある た め 、 同 じ 機 能 を $FF80 か ら $FFAF で も 実 
行 で きる よう に な り ま し た 。 

X68000 で も X68030 で も 動作 する プロ グラ ム を 書く ため に 、 今 後 は $FFS80 か ら $FFAF 
を コー ル す る よう に し て くだ さい 。 ( 各 コ ー ル の 詳細 は 、「 プ ログ ラマ ー ズ マニ ュ 
アル | を 参照 し て くだ さい 。) 

また 、 新 し く DOSINITO 関 数 が 、"CLIB_L" に 用 意 さ れ て いま す 。 各 DOS コ ー ル を 呼 
ぶ 前 に 、 こ の 関数 を コー ル す る こと と に より 、 ど の バー ジョ ン の OS で も 新しい DOS 
コー ル 番 号 で 使用 する こと が 可能 と な り ま す 。 

_- __MAIN.O か ら 始 まる プロ グラ ム で な い 通 常 の アセ ンプ ラプ ログ ラム を 書く 場合 
で 、 ス ー パ ー バ イザ ー モ ー ド で 参照 関数 を アク セス する 可能 性 が ある と き は 、 必 ず 
この 関数 を コー ル し た 後 で 使用 する よう に し て くだ さい 。 


IOCACHE 管 理 、 FAT 管理 、DIR 管 理 、FILENAME 管 理 の 一 部 を 取り 替え る こと を 可 


能 に する た め に os_patch コ ー ル が 追加 され まし た 。 

この 機能 を 利用 し た 外部 コマ ンド と し て FASTIO.XJFASTSEEK.XJFASTOPEN.X が 付 
属し て いま す 。 な お 、os_patch コ ー ル の 利用 に あたっ て は 、 シ ステ ム 内 部 の 詳細 な 知 
識 が 必要 な た め シ ステ ム 専 用 の コー ル と し ます 。 


オー プン 中 の ファ イル の 名 前 を 調べ る 場合 の た め に 、 使 用 中 の ファ イル の FCB を 得 


る こと が で きる get_fcb_adr が 追加 され まし た 。 


放 fiesnfies で ドラ イブ 番号 、 バ ス 名 が 獲得 で きる よう に な り ま し た 。 


5 記 9 し た ハン ドラ を close し た と き 、 フ ァイル 長 や 更新 日 時 の 書き 込み が 行わ れる よう 


に な り ま し た 。 た だ し 特殊 ブロ ッ ク デ バイ ス に 対し て は この 処理 は 行わ れ ま せん 。 


話 malloc2/6 malloc コ ー ル で 、 引数 と し て 親 の メモ リ 管 理 ポ イン タ の 先頭 を 指定 する こ 


と で 、 常 駐 プ ログ ラム や デバ イス ドラ イ バ か ら の メモ リ 確 保 が 可能 と な り ま し た 。 


2HD 以 外 の DISK の 種類 を 識別 する た め 、iocrl の コン トロ ー ル モー ド 13 が 機能 拡張 き 


れ ま し た 。 


CTRL 十 び 、P、N、QO、S を キー 入力 で 読め る よう に する た め に 、breakck が 機能 拡張 
され まし た 。 


2. 1 Human68K ver.3.0 
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ASK68K ver.3.0 


ここ で は 、 日 本 語 フ ロン ト プ ロ セッ サ ASK68K ver.3.0 で 追加 され た 、 ア クセ サリ に つい 
て 説明 し ます 。 


ASK68K の アク セ サ リ と は 、 か な 漢字 入力 を サポ ー ト する た め の 付 加 機 能 で す 。 
ASK68K は 、 内 部 に 組み 込み の アク セ サ リ と し て 、 記 号 ・ コ ー ド 入力 、 辞 書名 変更 、 単 語 
登録 な ど を 持っ て いま す 。 

ASK68K で は 、 バ ー ジ ョ ン 3 か ら の 新 機能 と し て 、 ア クセ サリ と し て 動作 する 外部 プロ グ 
ラム の 呼び 出し を サポ ー ト し まし た 。 ユ ー ザ は アク セ サ リ と し て 動作 する プロ グラ ム を 
作成 する こと に より 、ASK68K の 機能 を 拡張 する こと が で きま す 。 


外部 プロ グラ ム が アク セ サ リ と し て 動作 する た め に は 、 決 め ら れ た 方 法 で ASK68K に 組み 
込み を 行い 、 ま た 決め られ た 方 法 で ASK68K と パラ メー タ を 受け 渡し する 必要 が あり ま 
す 。 こ の 、ASK68K へ の 組み 込み 方 法 や 、ASK68K と の パラ メー タ の 受け 渡し 方 法 を 決め 
た も の を 、ACI (アク セ サ リ ・ イ ンタ ー フ ェ イ ス ) と 呼び ます 。 


まみ 下 園 け サンプ ブル アク セ サ リ の 説明 


氏 フ ァイル 一 覧 
XC ラ イブ ラリ ディ スク の \ASK30 の ディ レク トリ に 、 以 下 の 14 個 の ファ イル が 用 意 さ れ 
て で いま す 。 


SAMPLE.X 仕様 書 に 載せ た サン プル プロ グラ ム の 実行 形式 
FILES.SYS サン プル アク セ サ リ 1 

MODESW.SYS サン プル アク セ サ リ 2 

KANJISEL.SYS サン プル アク セ サ リ 3 

BUSHU.DIC 部 首 別 IS 第 2 水準 漢字 辞書 

MAKEFILE 全て の サン プル の メイ ク フ ァ イル 

ACI.H アク セ サ リ 共通 の ヘッ ダ 1 

ASKKEY.H アク セ サ リ 共通 の ヘッ ダ 2 

SAMPLE.C 仕様 書 に 記述 され て いる サン プル プロ グラ ム の ソー ス 
FILES_ TOUROKU.S サン プル アク セ サ リ 1 の ソー ス 

FILES.C ク 

MODESW.S ンプ グル ア ク 贅 才 サ 2 の ソー ス 

KANJI_ TOUROKU.S サン プル アク セ サ リ 3 の ソー ス 

KANJISEL.C ク 


オー トイ ンス トー ル で は 、 サ ンプ ルプ ログ ラム は コピ ー さ れ ま せん の で 、 


XC ラ イブ ラリ ディ スク の \ASK30 デ ィ レ クト リ か ら 空 き デ ィ ス ク や ハー ド 
ディ スク へ コピ ー し て ご ピ ご 利用 くだ さい 。 
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2. 2 ASK68K ver.3.0 


@SAMPLE.X に つい て 
"SAMPLE.X" は アク セ サ リ ・ イ ンタ ー フ ェ イ ス を 利用 し た サン プル プロ グラ ム で す 。 
起動 ・ 操 作 方 法 な ど は 「2-2-7 サ ンプ ルプ ログ ラム | を 参照 し て くだ さい 。 


僅 FILES.SYS/MODESW.SYS/KANJISEL.SYS の 組み 込み 方 法 

この 3 つの アク セ サ リ は ダミ ー の デバ イス ドライ バ と し て 常駐 し て 動作 し ます 。 
"CONFIG.SYS" を 下 の 例 の よう に 変更 し て 、 シ ステ ム を リセ ッ ト す る と 組み 込む こと が で 
まま 5 


[CONFIG.SYS の 例 ] 


DEVICE  \ASK3\ASK3.SYS /DA:\ASK3\ASKX5.DIC /EA:\ASK3\ASK3.ASK 
DEVICE ビ \ASK3\FILES.SYS 


DEVICE 三 \ASK3\MODESW.SYS 
DEVICE ビ \ASK3\KANJISEL.SYS /DA\ASK3\BUSHU.DIC 


"FILES.SYS" と "MODESW.SYS" に は 起動 時 オプ ショ ン は あり ませ ん 。 
"KANJISEL.SYS" は 、「/D 辞 書 の パス 名 | を オプ ショ ン と し て 指定 する 必要 が あり ます 。 
また 、 ア クセ サリ は いずれ も "ASK3.SYS" の 後に 組み 込ん で くだ さい 。 


@FILES.SYS の 使い 方 

仮 入力 中 また は 候補 選択 中 に 、"CTRL 登録 "キー を 押す と 、 漢 字 変換 枠 の 左端 に カレ ン 
トディ レク トリ の ファ イル 名 が 表示 され ます 。 カーソル キー で ファ イル 名 を 選択 し 、 リ 
ター ン キ ー で ファ イル 名 を 確定 し ます 。 以 下 の キ ー が 有効 で す 。 


に その 文字 が その まま 確定 する 

SHIFT 十 文字 キー その 文字 で 始ま る ファ イル 名 を 表示 する 

上 カー ソル ひと つ 前 の ファ イル 名 を 表示 する 

下 カ ー ソ ル 次 の ファ イル 名 を 表示 する 

リタ ー ン キー 現在 表示 中 の ファ イル 名 を 確定 する 
ESC,CTRL 登録 アク セ サ リ を 終了 し て 漢字 入力 モー ド に 戻る 
CTRL 十 XF1 アク セ サ リ と 漢字 入力 モー ド を 終了 する 


@MODESW.SYS の 使い 方 

仮 入力 中 に "XF1" キ ー を 押す と 入力 モー ド が 半角 に な り ま す 。 もう一度 "XF1" キ ー を 押す 
と 元 の 入力 モー ド に 戻り ます 。 

と の アク セ サ リ で は 「 全 角 ] 「 ひ ら が な | 「 ロ ー マ 字 | キー を 制御 し て いま す 。 
[CAPS] 「 か な | キー は 無視 し ます 。 
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2 春 パー ジョ ン 3.0: シ ステ ム 


で KANJISEL.SYS の 使い 方 

仮 入力 中 に 、"CTRL キ コー ド 入 力 " キ ー を 押す と 部 首 別に 漢字 が 表示 され ます (辞書 を 読 
み に い く の で し ば らく 時 間 が か か り ま す ) 。 記号 入 力 の 要領 で 漢字 を 選択 し 、 確 定 する 
だ が で きま すっ 。 

仮 入力 に 部 首 名 を 入力 し て こと の アク セ サ リ を 起動 する と 、 該 当 す る 部 首 群 を 検索 し て 表 
示し ます 。 そ う で な いと き は 辞書 の 先頭 か ら 表 示し ます 。 

辞書 は 添付 の "BUSHU.DIC" を 使用 し ます 。 こ れ は JIS 第 2 水準 漢字 に 部 首 の 読み 情報 を 付 
加 し た テキ スト ファ イル で す 。ASK3 本 体 の 辞書 と は まっ た く 別 物 で す 。 

画面 モー ド は 768X512 の み 対 応 し て いま す 。 

以下 の キー が 有効 で す 。 


左 カ ー ソ ル ひと つ 前 の 文字 を 選択 する 
右 カ ー ソ ル 次 の 文字 を 選択 する 

上 カー ソル ひと つ 前 の 部 首 群 に 行く 
下 カ ー ソ ル 次 の 部 首 群 に 行く 


CTRL 二 上 カー ソル 部 首 の 画数 が ひと つ 少 な 部 首 群 に スキ ッ プ する 
CTRL 二 下 カ ー ソ ル 部 首 の 画数 が ひと つ 多 い 部 首 群 に スキ ッ プ する 


リタ ー ン キー 現在 選択 し て いる 文字 を 確定 する 
ESC,CTRL 十 コー ド 入 力 アク セ サ リ を 終了 し て 漢字 入力 モー ド に 戻る 
CTRL 十 XF1 アク セ サ リ と 漢字 入力 モー ド を 終了 する 


注 意 | FILES.SYS、MODESW.SYS、KANJISEL.SYS の 解除 を 行う こと は で きま 
せん 。 


2. 2 ASK68K ver.3.0 
まま 上 人 AC| (アク セ サ リ ・ イ インター フェイス 仕様 ) 


アク セ サ リ の 動作 は 、 登 録 ・ 起 動 ・ 削 除 の 3 つ に 大 きく 分 か れ ま す 。 


@ ア クセ サリ の 登録 

ASK68K 内 部 の 登録 テー ブル に アク セ サ リ の 情報 を 書き 込む こと で 、 ア クセ サリ の 組み 込 
み を 行い ます 。 登録 テー ブル へ の 書き 込み は FP コ ー ル を 使っ て 行い ます 。 こ の と き 書 き 
込む 情報 は 「 ア クセ サリ を 起動 する た め の キ ー| 「 処 理 ル ー チ ン の 存在 する アド レス ] 
な ど で す 。 

この 後 、 ア クセ サリ は 自分 の 責任 で メモ リ 上 に 常駐 する 必要 が あり ます 。ASK68K は 登録 
され た アド レス を コー ル す る だ け で 、 処 理 ル ー チ ン そ の も の は ASK68K の 管理 下 に は 置き 
ませ ん 。 


@ ア クセ サリ の 起動 

登録 後 通常 の ASK68K の 使用 中 に は 、 ア クセ サリ は 全く コー ル さ れ ま せん 。 登録 時 に 指定 
し た 起動 キー が 入力 され た と き に 始め て アク セ サ リ が コー ル さ れ ま す 。 

アク セ サ リ が 起動 し た 後 は 、ASK68K は 1 つ キ ー 入 力 が ある た びに アク セ サ リ を コー ルレ し 
ます 。 全 て の キー 入力 は アク セ サ リ に 渡さ れ ま す 。 こ の 間 ASK68K 本 来 の 機能 は 停止 し ま 
す 。 ア クセ サリ は 、 1 つの 入力 キー に 対応 する 処理 を 行っ て 、ASK68K に 復帰 し ます 。 
この キー 入力 の タイ ミン グ に よる コー ル は 、 ア クセ サリ が リタ ー ン 値 と し て 「 ア クセ サ 
リ の 終了 ] を 返す まで 行わ れ ま す 。 

アク セ サ リ が 終了 する と 、ASK68K は アク セ サ リ を コー ル す る の を や め て 、ASK68K 本 来 
の 処理 を 再開 し ます 。 こ の 状態 か ら 起 動 キ ー の 入力 が ある と 、 再 び ア クセ サリ が 起動 さ 
れ 、 ま た 同じ 処理 が 行わ れん ます 。 


@ ア クセ サリ の 削除 

アク セ サ リ を 起動 きせ な いよ うに する に は 、ASK68K 内 部 の 登録 テープ ル に ある アク セ サ 
リ の 情報 を 削除 し ます 。 登録 テー ブル か ら の 削除 は FP フ ァ ン クシ ョ ンコ ー ル を 使っ て 行 
WW ます 。 

この 後 、 必 要 な ら ば アク セ サ リ は 自分 の 責任 で 常駐 解除 を 行っ て くだ さい 。 
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儲 ア クセ サリ の 登録 

アク セ サ リ の 登録 は 、ACCDEF (アク セ サ リ 定義 構造 体 ) を ASK68K に 渡す こと に より 行 
いま す 。 具体 的 に は 、ACCDEF へ の ポイ ンタ を 引数 と し て FP フ ァ ン クシ ョ ンコ ー ル 60 番 
を コー ル し ます 。FP フ ァ ン クシ ョ ンコ ー ル 60 番 は 、 リ ター ン 値 と し て アク セ サ リ ハン ド 
ル を 返し ます 。 こ の アク セ サ リ ハン ドル は 、 ア クセ サリ の 削除 の た め に 使い ます 。 
ASK68K ver.3.0 で は 最大 10 個 まで アク セ サ リ が 登録 可能 で す 。 


信 ACCDEF の 構造 
ACCDEF は 、 次 の よう に 定義 され て いま す 。 


typedef short (*FUNCPTR)(): 
typedef unsigned shortBIT16: 
typedef unsigned shorMEAN: 
typedef unsigned short * ACCMEAN: 
typedef unsigned char \XACCSTR: 


typedef struct { 
ACCSTR outstr: / テ \ 入力 文字 列 プ 確定 文字 列 */ 
ACCMEAN kwinstr: /※ 候補 ウィ ンド ウ 表 示 文 字 列 ※/ 
ACCMEAN mwinstr: /※ モー ドウ ィ ン ド ウ 表 示 文 字 列 */ 
} ACC_STRS: 


typedef struct { 
BIT16 invoke_stt: /※ 起動 状態 */ 
BIT16 invoke_key: /X 起動 キー テ / 


FUNCPTR acc func: /*※ アク セ サ リ エン トリ ※/ 
ACC_STRS acc_mes: /\ 文字 列 デー タ ※/ 
} ACC_DEF: 


FUNCPTR 型 。: 関 数 へ の ポイ ンタ で す 。ASK68K が アク セ サ リ を コー ル す る と き の 
エ シ ント リ と な り ま ず す 。 

BIT16 型 ・ 入力 キー の キー コー ド を 表し ます 。 

MEAN 型 ・ MEAN 文 字 を 表し ます 。MEAN 文 字 と は 、 変 換 枠 へ 文字 を 表 示す る 
た め の 表 示 属 性 を 含ん だ 文字 コー ド で す 。 

ACCMEAN 型 : MEAN 列 を 表し ます 。 MEAN 列 は 、(MEAN)0 で 終了 する MEAN 文 字 
の 配列 で す 。 

ACCSTR 型 。: アス キー 文字 、 シ フト JIS 文 字 か ら な る 文字 列 を 表し ます 。 
ヌル 文字 で 終了 し ます 。 


2. 2 ASK68K ver.3.0 
以降 で は 、 構 造 体 の 各 メ ン バ に つい て 詳細 に 解説 を 行い ます 。 


起動 時 の ASK68K の 状態 の 指定 (BIT16 invoke_st) 


アク セ サ リ を 起動 可能 な ASK の 状態 を 指定 し ます 。 
15 4 3 2 1 0 


候補 選択 モー ド 
仮 入 力 モー ド で 、 仮 入力 文字 が ある 
仮 入 力 モ ー ド で 、 仮 入力 文字 が な い 


アク セ サ リ の 登録 時 に 、 ビ ッ ト 0 、1、3 を 1 つ 以 上 1 に し て 設定 し ます 。 設 
定 し た 入力 モー ド の と き に 、 起 動 キ ー (invoke_key) の 押下 に よっ て アク セ サ 
リ が 起動 し ます 。 
設定 し て いな い 入力 モ ー ド で は 、 ア クセ サリ は コー ル さ れ ま せん 。 
ビッ ト 0 、1 、3 は 任意 の 組み 合わ せ で 設定 可能 で す 。 


・0 、1 、 3 以外 の ビッ ト は 無 梓 さ れ ま す 。 


・ 漢 字 入 力 モ ー ド に 入っ て いな いと き や 、 記 号 入 力 な どの 上 記 以 外 の モー ド の 
と き 、 他 の 外部 アク セ サ リ の 起動 中 に は 、 ア クセ サリ を 起動 する こと は で き 
ませ ん 。 

・"invoke_stt" は 定数 フィ ー ル ド と し て 扱っ て くだ さい 。 ア クセ サリ を 登録 し 
た と き の 値 を 登録 後に 変更 し て は いけ ませ ん 。 


例 仮 入力 中 に アク セ サ リ を 起動 可能 に 設定 し ます 。 


#define KS_EDITO 0x0001 
#define KS_EDITING 0x0002 


ACC_DEF acc: 


acc.invoke_stt 三 (KS_EDITOIKS_EDITING): 
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アク セ サ リ を 起動 する キー の 指定 (BIT16 invoke_key) 


アク セ サ リ を 起動 する キー を 指定 し ます 。 起動 キー に は 通常 文字 キー ( 英 数 


字 キ ー、 ス ペー スキ ー、 リ ター ン キ ー な ど ) と 特殊 キー (ファ ンク ショ ン 
キー、HELP キ ー な ど ) を 指定 で きま す 。 


 。 憶 -| 8 4 2 2 抽 0 9 5 7 0 


1: 特 殊 キ ー コ ー ド 
0: シ フト キー が 押さ れ て いな い 


1: シ フト キー が 押さ れ て いる 
し - 0: コ ント ロー ルキ ー が 押さ れ て いな い 
1: コ ント ロー ルキ ー が 押さ れ て いる 


キー コー ドキ コン トロ ー ル キー シフ トキ ー の 組み 合わ せ で 、 ア クセ サリ を 起 


動 す る キー を 設定 し ます 。 

キー コー ド は アス キー コー ド ま た は 特殊 キー コー ド を 使用 し ます 。 ビ ッ ト 8 が 
1 の 場合 、 特殊 キー コー ド で ある こと を 表し ます (特殊 キー コー ド に つい て は 
こと この節 の 最後 に 一 覧 を 示し ます ) 。 

通常 文字 キー で 起動 する よう に 設定 する 場合 、 ビ ッ ト 15 は 無効 に な り ま す 。 
コン トロ ー ル キー 通常 文字 キー で 起動 する よう に 設定 する と き に は 、 キ ー 
コー ド を コン トロ ー ル コー ド で 設定 し ます 。 


・ 不 正 を キー コー ド を 指定 し た 場合 、 そ の アク セ サ リ は 起動 され ませ ん 。 
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・ASK68K 本 来 の 機能 の キー アサ イン と ぶつ か っ て いる 場合 に は 、ASK68K の 
機能 の 方 が 効か な く な り ま す 。 

・"invoke_key" は 定数 フィ ー ル ド と し て 扱っ て くだ さい 。 ア クセ サリ を 登録 し 
た と き の 値 を 登録 後に 変更 し て は いけ ませ ん 。 


例 SHIFT+ ヘ ルプ キー で アク セ サ リ が 起動 する よう に し ます 。 


#define SHIFT_ON 0x0800 
#define NOT_ASCII 0x0100 
#define HELP_KEY 0x54 


ACC_DEF acc: 


acc.invoke_key 三 (SHIFT_ONINOT_ASCIIIHELP_KEY): 


2. 2 ASK68K ver.3.0 


アク セ サ リ の エン トリ ルー チン (FUNCPTR acc_func) 


ASK68K が アク セ サ リ を コー ル す る と き の エ ント リア ドレ ス を 設定 し ます 。 
エン トリ ルー チン は 、 次 の 形式 で 記述 し ます 。 


short acc_main( code ) 
BIT16 code: 
{ 


short re 


return(reD: 


] 


起動 キー の 押下 以降 、 ひ と つ キ ー 入 力 が ある ご と に ASK68K は この エン トリ 
ルー チン を コー 少し ます 。 そ の と きる 9 数 と し て 押下 キー の キー コー ド を アク 
セ サ リ に 渡し ます 。 
エン トリ ルー チン の コー ル は 、 ア クセ サリ が リタ ー ン 値 と し て アク セ サ リ 終 
了 コ ー ド を 返す まで 行わ れ ま す 。 
エン トリ ルー チン の 記述 法 の 詳細 は 「 ア クセ サリ の 起動 ] に て 解説 し ます 。 


注 意 | "acc_func" は 定数 フィ ー ル ド と し て 扱っ て くだ さい 。 ア クセ サリ を 登録 し た と 
き の 値 を 、 登録 後 に 変更 し て は いけ ませ ん 。 


起動 時 に 関数 acc mainOO) が コー ル さ れる よう に し ます 。 


ACC_DEF acc: 
short acc_main(): 


acCc.acc_func 三 acc_main: 
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ASK68K が アク セ サ リ を コー ル す る と き の エ ント リア ドレ ス を 設定 し ます 。 
エン トリ ルー チン は 、 次 の 形式 で 記述 し ます 。 


short acc_main( code ) 
BIT16 code: 
( 


short re 


return(reD: 


] 


解 説 | 起動 キー の 押下 以降 、 ひ と つ キ ー 入 力 が ある ご と に ASK68K は この エン トリ 
ルー チン を コー ル し ます 。 そ の と き 引 数 と し て 押下 キー の キー コー ド を アク 
セ サ リ に 渡し ます 。 
エン トリ ルー チン の コー ル は 、 ア クセ サリ が リタ ー ン 値 と し て アク セ サ リ 終 
了 コ ー ド を 返す まで 行わ れ ま す 。 
エン トリ ルー チン の 記述 法 の 詳細 は 次 ペー ジ を 参照 し て くだ さい 。 


注 意 | "acc_func" は 定数 フィ ー ル ド と し て 扱っ て くだ さい 。 ア クセ サリ を 登録 し た と 
き の 値 を 、 登 録 後に 変更 し て は いけ ませ ん 。 


起動 時 に 関数 acc main) が コー ル さ れる よう に し ます 。 


ACC_DEF acc: 
short acc_main(): 


acc.acC_func 三 acCC_main: 
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2. 2 ASK68K ver.3.0 


アク セ サ リ の 起動 


起動 キー ("invoke_stt" で 指定 し た キー) に より アク セ サ リ が 起動 する と 、ASK68K は ひと 
つ キ ー 入 力 が ある た びに アク セ サ リ の エン トリ ルー チン (acc func) を コー ル し ます 。 ア 
クセ サリ は 入力 キー に 対応 する 処理 を 行っ て 、ASK68K に リタ ー ン し ます 。 こ の と き 互 い 
に 受け 渡し する パラ メー タ に は 、 次 の よう な も の が あり ます 。 


仙 ASK68K か ら ア クセ サリ へ 
(1 ) 起動 時 の み 、ASK68K が その と き 変 換 中 の 文字 列 が "acc_mes.outsr" に 格納 され る 。 
(2 ) 入力 キー の キー コー ド を エン トリ ルー チン の 引数 と し て 受け 取る 。 


⑱ ア クセ サリ か ら ASK68K へ 
( 3 ) アク セ サ リ の 状態 を エン トリ ルー チン の リタ ー ン 値 と し て 返す 。 
(4 ) 漢字 変換 枠 に 表示 する 文字 列 、 ま た は 確定 文字 列 を "acc_mes" に 指定 し て 返す 。 


以降 で は 、 そ れ ぞ れ の パラ メー タ に つい て 説明 し ます 。 


( 1 ) ASK68K で 変換 中 の 文字 列 を 受け 取る 


アク セ サ リ が 起動 する と き に 、ASK68K よ り 現 在 変換 中 の 文字 列 を 受け 取り ま 


oO 


後 文字 列 が 渡さ れ ま す 。 
仮 入力 文字 が な いと き に は 、acc_mes.outsr [0] = ニ = "\O' が 保証 され ます 。 


アク セ サ リ が 起動 し た と き の ASK68K の 状態 に より 、 仮 入力 文字 列 ま た は 変換 


解 説 | 起動 キー の 押下 に よる アク セ サ リ の コー ル 時 に 、ASK68K で 変換 中 の 文字 列 が 
"acc_mes.outsr" に コピ ー さ れ て 渡さ れ て きま す 。 


注 竜 "acc_mes.outsrr'" は アク セ サ リ の 登録 時 に 十分 な 大 き さ の バッ ファ を 持っ て いる 
必要 が あり ます 。 必要 な バッ ファ サイ ズ は 仮 入力 可能 文字 数 と 同じ で す 。 
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(2) 入力 キ ー の キー コー ド を エン トリ ルー チン の 引き 数 と し て 受け 取る 
キー ボー ド か ら の 入力 を ASK68K よ り 受 け 取 り ま す 。 


半 34 0 4 ィ UL. 夫 、%.8。.?% 0 


キー コー ド の 種類 
0: ア スキ ー コ デザ 
1: 特 殊 キ ー コ ー ド 
0: テ ン キ ー か ら の 入力 で は な い 
1: テ ン キ ー か ら の 入力 で ある 
0: シ フト キー が 押さ れ て いな い 
1: シ フト キー が 押さ れ て いる 
0:CAP S が ロッ ク さ れ て いな い 
1:CAP S が ロッ ク さ れ て いる 
0: か な が ロッ ク さ れ て いな い 
1: か な が ロッ ク さ れ て いる 
0: コ ント ロー ルキ ー が 押さ れ て いな い 
1: コ ント ロー ルキ ー が 押さ れ て いる 


エン トリ が コー ル さ れる と 、 必 ず 引 数 と し て キー コー ド が 渡さ れ ま す 。 
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下位 8 ビッ ト が キー コー ド を 表し ます 。 キ ー コ ー ド は アス キー コー ド ま た は 特 
殊 キ ー コ ー ド で す 。 ビ ッ ト 8 が 1 の 場合 、 特 殊 キ ー コ ー ド で ある こと を 表し ま 
す (特殊 キー コー ド に つい て は この 節 の 最後 に 一 覧 を 示し ます ) 。 

ビッ ト 9 が 1 の と き 、 入 力 が テン キー か ら で あ る こと を 表し ます 。 

ビッ ト 10 一 ビッ ト 15 は 、 同 時 に 押さ きれ て いる キー を 表し ます 。 


2. 2 ASK68K ver.3.0 


( 3 ) アク セ サ リ の 状態 を エン トリ ルー チン の リタ ー ン 値 と し て 返す 


解 


説 


アク セ サ リ か ら 処 理 が 戻っ た 直後 の ASK6SK の 処理 を 指定 し ます 。 


3 14 13 必 1 10 9》 


生み 2 ま ) の コー ル 寺 0 
Ox00: 次 の キー 入力 で コー ル 
0x02: す ぐに コー ル 
Ox03: 確 定 が 終わ っ て か ら コ ー ル 
OxFF: ア クセ サリ の 終了 


0: 入 力 キ ー を ASK68K に 再 利用 し な い 
1: 入 力 キ ー を ASK68K に 再 利用 する 
0: モ ー ド 表示 ウィ ンド ウ に 表示 し な い 
1: モ ー ド 表示 ウィ ンド ウ に 表示 する 
0: 候 補 ウ ィ ン ド ウ に 表示 し な い 
1: 候 補 ウ ィ ン ド ウ に 表示 する 
0: 確 定 し な い 
1: 確 定 する 


エン トリ ルー チン の 戻り 値 (short) で は 、 
・ 次 回 の アク セ サ リ の コー ル 時 期 
隊 CA を ASK68K で 利用 する 、 しない 
変換 枠 へ の 表示 を 行う 、 行 わな い 
を 挫 や する 。 し な い 
を ASK68K に 指定 し ます 。 


下位 8 ビッ ト は 、 次 回 に ASK6SK が アク セ サ リ を コー ル す る タイ ミン グ を 指定 
し ます 。 

Ox00 を 指定 する と 、 次 の キー 入力 が あっ た 時 点 で コー ル さ れ ま す 。 ア クセ サリ 
が 次 の キー 入力 を 受け 取る と き に 利用 し ます 。 

Ox02 を 指定 する と 、 す ぐに コー ル さ れ ま す (ユー ザ プ ロ セス に 処理 が 戻り ませ 
ん ) 。 変換 枠 に 表示 を し た ら す ぐに アク セ サ リ を コー ル し て 欲し いと き な ど に 
利用 し ます 。 

0x03 を 指定 する と 、 確 定 文字 列 が 全部 ユー ザ プロ セス に 読ま れる の を 待っ て か 
ら 次 の キー 入力 で コー ル さ れ ま す 。 

OxFF は 、 ア クセ サリ の 終了 を 表し ます 。 
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ビッ ト 8 は 、 入 力 キ ー を ASK68K 本 来 の 機能 が 解釈 する た め に 指定 し ます 。 例 
えば 、"CTRL 十 XF1" キ ー で アク セ サ リ を 終了 し 、 同 時 に 漢字 入力 モー ド を 終了 
する よう な 機能 の 実現 に 利用 し ます 。 こ の ビッ ト の 指定 は 、 下 位 8 ビッ ト で 
「 ア クセ サリ の 終了 ] を 指定 し た 場合 に の み 有 効 で す 。 


ビッ ト 9 は 、"acc_mes.mwinsr" で 指定 し た 文字 列 を モー ド 表 示 ウ ィ ン ド ウ に 表 
示し ます 。 ビ ッ ト 10 は 、"acc_mes.kwinsr" で 指定 し た 文字 列 を 候補 ウィ ンド ウ 
に 表示 し ます 。 ビ ッ ト 11 は 、"acc_mes.outsr" で 指定 し た 文字 列 を 確定 し ます 。 
ビッ ト 9 、 10、11 で 指定 する 確定 表示 動作 は アク セ サ リ か ら 処 理 が 戻っ た 直 
後に 行わ れ ま す 。 


「 次 の キー 入力 を 待た ず に コー ル ] を 指定 し た 場合 、 次 回 コー ル 時 の 引数 に は 
Ox00 が 渡さ れ ま す 。 


( 4 ) 確定 文字 列表 示 文 字 列 を 返す 


ASK68K と アク セ サ リ で 文字 列 を 受け 渡す た め の バ ッ フ ァ ア ドレ ス を 指定 し ま 
す 。 


acc_mes.outsrr:ASK68K で 変換 中 の 文字 列 の アド レス 、 ま た は 、 確 定 文字 列 の ア 
ドレ ス 
acc_mes.kwinsrr: 候 補 ウ ィ ン ド ウ に 表示 する 文字 列 の アド レス 
acc_mes.mwinstr: モ ー ド 表示 ウィ ンド ウ に 表示 する 文字 列 の アド レス 


3 つの バッ ファ は 、 そ れ ぞ れ エ ント リル ー チ ン の リタ ー ン 値 の ビッ ト 11、10、 
9 に 対応 し て 使わ れ ま す 。 


注 意 | ・ 候 補 ウ ィ ン ド ウ の 表示 可能 文字 数 は その と き の 画 面 モ ー ド に より 80 文 字 ま た 
は 48 文 字 (全角 で 40 文 字 ま た は 24 文 字 ) で す 。 
・ モ ー ド 表示 ウィ ンド ウ の 表示 可能 文字 数 は 最大 12 文 字 (全角 6 文字 ) まで 表 
示さ れ ま す 。 
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2. 2 ASK68K ver.3.0 


だま 久 アク セ サ リ の 削除 


アク セ サ リ の 削除 は 、 ア クセ サリ の 登録 時 に 得 ら れん た アク セ サ リ ハン ドル を 指定 し て FP 
ファ ンク ショ ンコ ー ル 61 番 を コー ル し ます 。 


の まみ 本 プロ グラ ミン グ 上 の 留意 点 


アク セ サ リ は CON デ バイ ス の 一 部 と し て 動作 し ます 。 ア クセ サリ の 作成 に あたっ て は CON 
デバ イス を 作成 する 場合 と 同様 の 点 に 注意 する 必要 が あり ます 。 


@⑱ ア クセ サリ の 動作 する 環境 
アク セ サ リ は スー パー バイ ザ モ ー ド で 動作 し ます 。 


信 DOC コ ー ル の 使用 

アク セ サ リ か ら DOS コ ー ル を 呼ぶ こと が で きま す 。 こ の と き 、CON が 再起 呼び 出し され な 
いよ うに する た め に 、 一 時 的 に プレ ー ク チェ ッ ク を し な い ($FF33) よう に 設定 し て くだ 
さき V。 


人 @ フ ァイル アク セス 

DOS コ ー ル を 利用 し て ファ イル アク セス を 行う こと が で きま す 。 フ ァイル を オー プン 
($FF3D) | する と き に アク セス モー ド の 辞書 アク セス ビッ ト (ビッ ト 8) を ON に し て く 
だ さい 。 得 ら れ た ファ イル ハン ドル を 使っ て 、 通 常 と 同じ ファ イル 操作 が 可能 で す 。 
辞書 アク セス ビッ ト を ON に し て オー プン で きる ファ イル の 数 は Human68k 全 体 で 同時 に 2 

個 ま で と な っ て いま す 。 1 つ は ASK68K の 辞書 が 使用 し て いる の で 、 残 り 1 つ を アク セ サ 
リ で 使用 で きま す 。 
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の まま 信和 特 殊 キ ー コ ー ド 一 覧 


BIT16 型 で 表 さ れる キー コー ド の 下位 8 ビッ ト 特 殊 キ ー コ ー ド は 、 次 の よう に 定義 され て 
W ま すず 。 


NO_CHAR (キー 入力 が な か っ た ) 
C34 KEY (ひら が な の 「 ろ | の キー) 
HOME_KEY (HOME) 

DEL_KEY (INS) 

ROLLUP_KEY (ROLLUP) 
ROLLDOWN_KEY (ROLLDOWN) 
UNDO_KEY (UNDO) 

LEFT KEY (カー ソル ーー) 

UP KEY (カー ソル 1 ) 

RIGHT_KEY (カー ソル 一 ) 
DOWN_KEY (カー ソル ! ) 
CLR_KEY (CLR) 

KIGOU_KEY (記号 入力 ) 
TOUROKU_KEY (登録 ) 

HELP KEY (HELP) 

XF1_ KEY (XF1 ) 

XF2_KEY (XF2 ) 

XF3_KEY (XF3 ) 

XF4 KEY (XF4 ) 

XFS KEY (XF5) 

KANA_IN (か な 、LED 点 灯 ) 
KANA_OUT (か な 、LED 消 えた ) 
ROMAJI_ IN (ロー マ 字 、LED 点 灯 ) 
ROMAJI OUT (ロー マ 字 、LED 消 えた ) 
CODE_IN (コー ド 入 力 、LED 点 灯 ) 
CODE_OUT (コー ド 入 力 、LED 消 えた ) 
INS_IN (INS、 LED 点 灯 ) 

INS_OUT (INS、LED 消 えた ) 
HIRAGANA_IN (ひら が な 、 LED 点 灯 ) 
HIRAGANA_OUT (ひら が な 、LED 消 えた ) 
ZENKAKU_IN (全角 、LED 点 灯 ) 
ZENKAKU_OUT (全角 、LED 消 えた ) 
BREAK_KEY (BREAK) 

COPY_KEY (COPY) 

FKEY1_ KEY (F1 ) 

FKEY2 KEY (F2 ) 

FKEY3 KEY (F3 ) 
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FKEY4 KEY (F4) 
FKEYS KEY (F5) 
FKEY6 KEY (F6) 
FKEY7 KEY (F7) 
FKEY8 KEY (F8) 


FKEY9 KEY (F9 ) 

FKEY10_ KEY (F1 0 ) 
OPTI_LOCK (OPT 1 押し た ) 
OPT2_LOCK (OPT 2 押し た ) 
OPTI_UNLOCK (OPT 1 離し た ) 


の 


2 ASK68K ver.3.0 
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ゆま 沈 2 角 人 CI 用 の FP コ ー ル 


60 番 一 63 番 が ASK ver.3.0 か ら 新しく 追加 され まし た 。 
FP コ ー ル 50 番 で バー ジョ ン 番 号 を 確認 し て か ら コ ー ル する よう に し て くだ さい 。 


FP コ ー ル 番号 : 6 0 
アク セ サ リ の 登録 


引 数 


ACCDEF アク セ サ リ 定義 構造 体 


PEA ACCDEF 
MOVE.L #60, 一 (⑤P) 
DC.W _KNJCTRL 


ADDOL  #SSP 


DOL アク セ サ リ ハン ドル また は エラ ー コ ー ド 


>=0 アァ アクセサリ ハン ドル 
ニー1 エラ ー 


アク セ サ リ を 登録 し ます 。 


FP コ ー ル 番号 : 61 
アァ ク セ サ リ の 削除 


引 数 


ー 


ACCHANDLE アク セ モ サ リハ ンド ル 


MOVE.L #ACCHANDLE, 一 (SP) 
MOVEL  #61. 一 (SP) 

DC.W _KNJCTRL 

ADDO 工 #5,SP 


DOL また は キラー ロー ド 
=0 正常 終了 
ーー1 テラ ー 


ASK68K 内 部 に ある テー ブル か ら 、 ア クセ サリ の エン トリ を 削除 し ます 。 
アク セ サ リ は 以後 呼び 出さ れ な く な り ま す 。 


2. 2 ASK68K ver.3.0 


FP コ ー ル 番号 : 6 2 


文字 列 を MEAN 列 へ 変換 する 


引 数 | STR シフ ト JIS 文 字 列 
MBUF MEAN 列 格納 バッ ファ 
KIND 属性 
通常 表示 
1 反転 表示 
コ ーー ル PEA STR 
PEA MBUF 
MOVEL  #KIND, 一 SP) 
MOVEL #62, 一 (SP) 
DC.W _KNJCTRL 
LEA 16(SP),SP 
DOL 格納 し た MEAN 列 の 長き 


アス キー コー ド と シフ ト JIS コ ー ド か ら な る 文字 列 を MEAN 列 へ 変換 し ます 。 


FP コ ー ル 番号 : 6 3 


MEAN 列 の 指定 位置 の 属性 変更 


引 数 | MBUF MEAN 列 
LEN 変更 する 長 さ 
KIND 属性 
三 通常 表示 
三 反転 表示 
コ ーー ル pEA STR 
PEA MBUF 
MOVEL  #KIND, 一 (SP) 
MOVEL  #63, 一 (SP) 
DC.W _KNJCTRL 
LEA 16(SP),SP 
DOL 0 


渡 き れ た MEAN 列 の 先頭 か ら 指定 され た 長 さ 分 だ け 表 示 属 性 を 変更 し ます 。 
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の 定 き 民 サン プル プロ グラ ム 


ここ で は 、 サ ンプ ルプ ログ ラム SAMPLE.C を 使っ て 、 実 際 の アク セ サ リ の 作成 方 法 を 解 
説 し ます 。 


サン プル プロ グラ ム の 操作 方 法 


SAMPLE.X を 実行 する と アク セ サ リ の 登録 メッ セー ジ が 表示 され た 後 、 キ ー 入 力 待ち に 入 
り ます 。 

ここ で 、 漢 字 入力 モー ド に 入り 、 起 動 キ ー を 押す と 次 の 2 つの アク セ サ リ が 起動 し ます 。 
食 変 換 中 の 文字 列 の 1 6 進 ダ ンプ 

変換 枠 に 入力 が ある 状態 で HELP キ ー を 押す と 起動 し ます 。 変換 中 の 文字 列 を ダン プ し た 
も の を 確定 文字 列 と し て 出力 し 、 即 座 に 終了 し ます 。 出力 で きる の は 変換 中 の 文字 列 の 先 
頭 か ら 20 バ イト まで で す 。 


人 @10 進 一 一 16 進 変換 機能 
仮 入力 中 に "CTRL 二 O" を 押す と 起動 し ます 。 起動 する と 変換 枠 の 表示 が 


Dec [ 0] 
の よう に な り ま す 。 こ の 状態 で 、 次 の キー が 有効 で す 。 


0-9,A 一 EF,a 一 f 数値 の 入力 


系 党 10 進 一 一 16 進 表示 切り 替え 

リタ ー ン キー 現在 表示 中 の 数 値 を 確定 する 

ESC アク セ サ リ を 終了 し て 漢字 入力 モー ド に 戻る 
CTRL 十 XF1 アク セ サ リ と 漢字 入力 モー ド を 終了 する 


2. 2 ASK68K ver.3.0 


サン プル プロ グラ ム 


ここ で は 、SAMPLE.C の リス ト を 示し 、 解説 を 行い ます 。 


1/※% 

2X※X※ サン プル アク セ サ リ for ASKver3.0 
3%X Copyright (C) 1993 ACCESS CO.,LTD. 
4 ※/ 

5 者 nclude "aci.h" 

6 双 nclude "askkey.h" 

7 typedef unsignedchar uchar: 


9short acc1_main(), acc2_main(): 

10uchar cbuf [80] : 

11MEAN kbuf [80] : 

12MEAN mbuf[20] : 

13 

14ACC_DEF acc1 三 { 
KS_EDITINGIKS_SELECT, /※ invoke_stt ※/ 
NOT_ASCIIIHELP_KEY, /% invoke_key ※/ 
acc1_main, /X% acC_fUunC ※/ 


Cbuf, kbuf, mbuf 


23ACC_DEF acc2 三 { 

24 KS EDITOIKS_EDITING, /X invoke_stt ※/ 
(Q 一 ⑨), /% invoke_key ※/ 
acc2_rmain, /% acCC_ fUnC ※/ 


cbuf, kbuf, mbuf 


32 short acc1_main(code) 
33 BIT16 COQ6e: 


static u char tmp [21] : 
u char *lohex(), \strcat(): 
u Char ※P: 

int iiH 


for (p 三 cbuf,i= 0:i く 20: 填 十 ) 【 
『(\p ーー \0) 
break: 
tmp [i] = テ *p 十 十 : 
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45 tmp 遇 三山 テツ \0: 
46 cbuf [0] = ツ \0' 
47 for(i 王 0:i く 上 : 十 十 ) { 


48 strcat(cbuftohex((long)tmp [i] )): 
49 strcat(cbuf," 9: 

50 ) 

51 return(DF_OUTSTRICACI_END): 
52 } 

53 

54u char digi [15] : 

55 

56u char  ※Hoa(b) 

57 unsignedlong 上 上 

58 { 

59 registerint 

60 


61 digit [14] = ツ "0 
62 for(i 三 13:i>= テ 0:i 一 一 ) { 


63 digt [ii = ニ I%10 十 0 
64 I/ 三 10: 

65 } 

66 for(i 三 0:i く 13: 十 十 ) { 

67 (digtt [ii ! 0) 

68 break: 

69 )} 

70 return(&digit [| ): 

71} 

72 


73uchar  ※lohex(|) 
74 unsignedlong 上 上 


76 registerint i 
77  UUCNaT G: 


79 digit [14] = テツ 0: 
80 for(i 三 13:i> 5:i 一 一 ) { 


81 c 三 1& Ox0000000f: 
82 ff(c く 10) 

83 c 十 三 0" 

84 else 

85 c 十 WW 一 10: 
86 digit [i] ニ ci 

87 1 テッ > 4 

88 )} 

89 for(i 三 6:i く 13: 証 十 ) { 
90 (digtt [| !'0) 
91 break: 

92 


] 
93 retum(&digit [] ): 


清 ョ ン 3 . シ ステ ム 


94 」 
95 


2. 2 ASK68K 


96 short acc2_main(code) 
97 BIT16 COQ6e: 


staticint first 三 1: 

static u char display [20] : 
static unsigned long val: 
staticint mode: 

staticint hexmode 三 0: 
BIT16 nc,mask_key(): 

u char XD, \StrCDy(): 

int | strlen(): 


if (firs1) { 
first 三 0: 
mode 0: 
val 三 0L: 
Qoto diSp: 


nc 三 mask_key(code): 

『 (nc デー \) 
strcpy(cbuf,hexmode ? ohex(val) : loa(val): 
mode 三 1: 
return(DF_OUTSTRICACI_SUSPEND): 


1) 
if (hc デー (CTRL_ONINOT_ASCIIIXF1_KEY)) { 
first 三 1: 
return(KEY_AGAINICACI_END): 
) else 『 (hc デー \033) { 
first 三 1: 
return(CACI_END): 


) 
if (nc & NOT_ASCII) 
return(CACIL_NORMAL): 


nc & 三 Oxff: 
if (nc > デー 'a'&& nc ベア ) 
nc 一 デー Ai 
if (nc デー 'X) { 
hexmode 三 1 一 hexmode: 
mode 三 1: 
) else (nc >= 0'&& nc く = テ 9'|nc > デ 'A&&nc ベーFF){ 
if (nc > A) { 
if (!hexmode) 


return(CACI_NORMAL): 
nc 一 一 O' 一 10: 
1 
if (mode ! 0) { 
val 三 0L: 


Ver.3.0 
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143 mode 0: 

144 ) 

145 nc 一 三 05 

146 if (hexmode) { 

147 val 三 (val くく 4) |nc: 
148 } else { 

149 val 三 (val * 10) 十 nci 
150 

151 } 

152 disp: 


153 sircpy(display,hexmode ? "Hex " : "Dec の ): 
154 strcat(display," [9: 

155 phexmode ? lohex(val) : Noa(val): 
156 | 三 10 一 strlen(D): 

157 while (| 一 一 > 0) 

158 strcat(display," 9: 

159 strcat(display,D): 

160 sitrcat(display,"] "7: 

161 | 三 sstrtom(display,kbuf,0): 

162 kbuf [ 則 =0 

163 return(DF_KWINSTRICACI_NORMAL): 


166BIT16 mask_key(code) 

167BIT16 code: 

168 { 

169 code& 王 (OxffICTRL_ONISHIFT_ONINOT_ASCID: 
170 『W(!(code & NOT_ASCII)) 


171 code & 三 CTRL_ON: 
172 return(code): 

173 } 

174 


175u char 。%※strcat(S1, S2) 
176u char  ※Ss1,※S2: 


ZZ71 

178 uchar *ret 三 Ss1: 

179 

180 while (Xs1) 

181 8 キキ 十 : 

182 while (*s1 十 十 三 *S2 十 十 ) 
183 と 

184 return(ret): 

185 } 

186 


187u char 、※strcpy(S1, S2) 
188u char ※Ss1,%S2: 

189 { 

190 uchar ※*ret 三 Ss1: 

191 
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192 while (*s1 十 十 三 *S2 十 十 ) 
193 6 

194 return(ret): 

195 } 

196 

197 int strlen(S) 

198u char  %S: 
199 { 

200 uchar Xp 三 58: 
201 

202 while (XS) 

203 5 We 

204 return(s 一 DD): 
205 ) 


207 short brksts: 


209 int sstrtom(str, buf, mode) /* FP コ ー ル 62 番 */ 
210u char %※str: /% 8(46) ※/ 
211 MEAN X buf: /X 12(a6) ※/ 

212 int mode: /※% 16(a6) ※/ 

213 { 

214 #asm 

215 move.w #ー1. 一 (SD) 

216 .dc.w $ff33 ーー ーー ニテ 
217 addq.|I #2,SD 

218 move.w dO, brksts 
219 clrw 一 (SD) 
220 .dc.w $ff33 


221 addq.| #2,Sp 


223 move.| 16(a6), 一 (SD) 
224 move.| 12(a6), 一 (SD) 
225 move.| 8(a6), 一 (SD) 
226 move.| #62, 一 (SD) 
227  .dc.w $ff22 

228 lea.| 16(SD),sp 


230 move.| d0, 一 (SD) 

231 move.w _brksts, 一 (SD) 

232 .dc.w $ff33 

233 addq.| #2,Sp 

234 move.| (SD) 十 ,d0 

235 #endasm 

236 ! 

237 

238 /* [ここ まで ] CON の 一 部 (スー パー バイ ザ モ ー ド で 動作 する ) 
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239 *※\ [ここ か ら ] ユー ザ モ ー ド 

240 テ / 

241 

242 int askver() /% FP コ ー ル 50 番 ※/ 
243 { 

244 #aSm 

245 move.| #50, 一 (SD) 

246  .dc.w $f22 

247 addq.| #4.Sp 

248 #endasm 

249 } 

250 

251 int acc_touroku(accdef) /* FP コ ー ル 60 番 テ / 
252 ACC_DEF テ accdef: / テ 8(a6) ※/ 
253 { 

254 #asm 

255 move.| 8(a6), 一 (SD) 

256 move.| #60, 一 (SD) 

257  .dc.w $ff22 

258 addq.I #8,Sp 

259 #endasm 

260 } 

261 

262 int acc_delete(acc_handle) /% FP コ ー ル 61 番 え / 
263 int acc_handle: 

264 { 

265 #asm 

266 move.| 8(a6), 一 (SD) 

267 move.| #61, 一 (SD) 

268  .dc.w $ff22 

269 addq.I #8,Sp 

270 #endasm 

271 } 

272 

273 雪 nclude ぐ stdio.h> 

274 導 nclude く signalh> 


275 

276 int ah1, ah2: /*※ アク セ サ リ ・ ハ ンド ル ※/ 
277 

278 void die() 

279 { 

280 /*X アク セ サ リ を 削除 する */ 

281 (acc_delete(ah1) デー 0) 

282 printf((" ア クセ サリ 1 を 削除 し まし た .\n"): 
283 (acc_delete(ah2) デー 0) 

284 printf((" ア クセ サリ 2 を 削除 し まし た .\n"): 
285 exi(1): 

286 ) 

287 


2. 2 ASK68K ver.3.0 


288 void main() 


/* ASK の バー ジョ ンチ ェ ッ ク ※\/ 

if (askver() ぐ 300) { 
Printf(("ASK の バー ジョ ン が 3 以上 で は あり ませ ん .\n9): 
exit(1): 

] 


signal(SIGINT, die): 


/% アク セ サ リ を 登録 する ※/ 

if ((ah1 三 acc_touroku(&acc1)) ニー ー1) 
printf(" ア クセ サリ 1 を 登録 で きま せん .\n"): 

else 


prinf(" ア クセ サリ 1 を 登録 し まし た .\n"): 
if ((ah2 三 acc_touroku(&acc2)) デー ー1) 
prinf(" ア クセ サリ 2 を 登録 で きま せん .\n"): 
else 
prin(" ア クセ サリ 2 を 登録 し まし た .\n"): 


/*※ アク セ サ リ を 試す */ 
while (getchar() ! 三 EOF) 


die(): 
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人 変数 の 宣言 と 定義 

( 5 行 ) ACCDEF の 宣言 を イン クル ー ド 。 

( 6 行 ) 特殊 キー コー ド の 定数 定義 を イン クル ー ド 。 
(14 行 ) 16 進 ダン プ の ACCDEF。 

(23 行 ) 10 進 一 16 進 変換 の ACCDEF。 


@1 6 進 ダ ンプ の アク セ サ リ 
(32 行 ) 16 進 ダン プ の エン トリ ルー チン 。 
(31 行 ) 文字 列 を 確定 し て さら に アク セ サ リ を 終了 させ ます 。 


@10 進 一 …16 進 変換 の アク セ サ リ 

(96 行 ) 10 進 一 >16 進 変換 の エン トリ ルー チン 。 

(108 行 ) "first' は アク セ サ リ が 起動 され た 最初 の コー ル か どう か を 示す フラ グ で す 。 アク 
セ サ リ で 初期 化 を 行う 必要 が ある と き は 、 こ の よう な フラ グ を 用 いて 初期 化 処 理 を 記述 す 
る 必要 が あり ます 。 

(118 行 ) 入力 が だが リターン キー の と き 、 値 を 文字 列 に 変換 し て 確定 し ます 。 さ ら に 、 次 回 の 
アク セ サ リ の コー ル は 確定 が 終わ る まで 待ち ます 。 

(122 行 ) 入力 が "CTRL 十 XF1" の と き 、 ア クセ サリ を 終了 し て さら に 入力 キー を ASK68K に 
再 利 用 させ ます 。 こ れ に より 、 ア クセ サリ と 漢字 入力 モー ド を 同時 に 終了 する 機能 を 実現 
し で ゆい ます 。 

(12 行 ) 変換 枠 へ の 表示 デー タ を 作成 し ます 。 シ フト JIS と アス キー で 普通 に 表示 デー タ 
を 作成 し た あと FP コ ー ル 62 番 で MEAN 絢 に 変換 し ます 。 


@ サ ブル ー チ ン 
(209 行 ) 文字 列 を MEAN 列 へ 変換 する FP コ ー ル 62 番 を 呼び 出し ます 。 
FP コ ー ル の 前 後に プレ ー ク チェ ッ ク を 制御 し て いま す 。 


⑯ ア クセ サリ の 登録 と 起動 

(291 行 ) ACI を 利用 する た め に 、ASK68K.SYS の バー ジョ ン を 調べ て いま す 。 
(299 行 、303 行 ) FP コ ー ル 60 番 で アク セ サ リ を 登録 し ます 。 

(309 行 ) この ルー プ の 中 に いる 間 、2 つの アク セ サ リ を 使う こと が で きま す 。 
(281 行 ) FP コ ー ル 61 番 で アク セ サ リ を 削除 し ます 。 
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リガ 


OPMDRV3 
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可 是 


「C compilerPRO-68Kver2.1 NEW KIT| で は 新た に X68030/X68000 対 応 の FM 音源 MIDI 
グ ADPCM を 同時 に コン トロ ー ル で きる 機能 が 追加 きれ て いま す 。 こ れ に より 、 以 下 の 
ファ イル が 追加 変更 きれ て いま す 。 


ファ イル 名 内 容 
MUSIC.DEF | FM 音源 (MIDIADPCM 対 応 ) 用 DEF フ ァイル 
MUSIC3.DEF | FM 音源 /MIDIADPCM 用 拡張 DEF フ ァイル 
AUDIO.FNC | ADPCM 外 部 関数 

MUSIC.FNC | FM 音源 (MIDIIADPCM 対 応 ) 用 外部 関数 
MUSIC3.FNC | FM 音源 /MIDIIADPCM 用 拡張 外部 関数 


MUSIC.H FM 音源 (MIDIADPCM 対 応 ) 用 関数 の 定義 
MUSIC3.H FM 音源 /MIDIIADPCM 用 拡張 関数 の 定義 
BASLIBL BASTOC ラ イブ ラリ 


これ ら の ファ イル を 利用 し て 作成 し た プロ グラ ム を 動作 させ る た め に は 、OPMDRV3.X 
が 必要 で す 。 

な お 、 従 来 の OPMDRV2.X 用 の ファ イル は 、XC ラ イブ ラリ ディ スク の MUSIC ディ レク ト 
居 引 太っ で まま すま 。 

また 、BASIC コ マン ド に つい て は X68030、 も し く は SX-WINDOW ver3.0 シ ステ ムキ ッ ト 
に 付属 の 「X-BASIC ver2.0 ユ ー ザ ー ズ リフ ァ レ ンス 」 を 参照 し て くだ さい 。 


2. 3 OPMDRV3 


新しい ミュ ー ジ ッ ク の 機能 を 使用 する た め に 、 次 の よう に CINFIG.SYS、BASIC.CNF を 設 
定 し て くだ さい 。 

な お 、 以 下 の 設定 を フロ ッ ピ ー デ ィ ス ク で は 、 オ ー ト ・ イ ンス トー ル (INSTALLX) で 
自動 的 に 行 な ん ます 。 

また 、 ハ ー ド ディ スク で は 、 オ ー ト ・ イ ンス トー ル で CONFIG.SYS の 登録 以外 は 自動 的 
に 行なえ を ます 。 (C ユ ー ザ ー ズ マニ ュ ア ル 参 照 ) 


借 CONFIG.SYS 
1 ) SYS ディ レク トリ に OPMDRV3.X を コピ ー し て くだ さい 。 
2 ) CONFIG.SYS に 次 の よう に OPMDRV3.X を 登録 し て くだ さい 。 


『ーー CONFIG.SYS の 例 
FILES 三 30 
BUFFERS 三 20 1024 
LASTDRIVE = Z: 
KEY = \KEY.SYS 
USKCG = \USKCG.SYS 
BELL ー \BEEP.SYS 
DEVICE = \SYS\PRNDRV.SYS 
DEVICE = \SYS\IOCS.X 
DEVICE = \SYS\FLOAT2.X 
DEVICE = \SYS\ASK68K.SYS /DB:\X68K.DIC /E\ASK\ENV1.ASK 
DEVICE = \SYS\OPMDRV3.X#180 /P64 /OPM 
DEVICE = \SYS\RAMDISK.SYS #G 
DEVICE = \SYS\FDDEVICE.X 
DEVICE = \SYS\HISTORY.X /D\HIS\ /SH2,8,4 
ENVSET 三 512 \STARTUP.ENV 
EXCONFIG デ \SYS\CONFIGED.X 


注 意 |PCMDRV.SYs の 機能 は 、OPMDRV3.X に 含ま れ て いま す の で 登録 する 必要 
は あり ませ ん 。 
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の 生ま だ 人 牟 楼 能 説明 
OPMDRV3.X で は 、FM 音 源 プ MIDI プ ADPCM を 次 の よう に 同時 に コン トロ ー ル で きま 
n 
な お 、OPMDRV3 メ は OPMDRV.X の 上 位 互換 に な っ て いま す が 、OPMDRV2 又 と は 互換 
性 が あり ませ ん の で ご 注意 くだ さい 。 


信 以 下 の デ バイ ス 名 を サポ ー ト し て いま す 。 


PCM PCM の 録音 / 再 生 

MIDI、OPM MML デ ー タ の 再生 、 及 び 各 コマ ンド の 実行 

MIDIA アス キー ファ イル を MIDI コ ー ド に 変換 し て MIDI OUT へ 出力 

MIDIB バイ ナリ ー フ ァイル を その まま MIDI デ ー タ と し て 出力 

MIDIAE アス キー エク スク ルー シ プ デ ー タ ファ イル を MIDI コ ー ド に 変換 し て 
出力 (Musicstudio PRO-68K で 作成 され る EXC フ ァイル な ど ) 

MIDIBE バイ ナリ ー エク スク ルー シ プ デ ー タ ファ イル を その まま MIDI デ ー タ 


と し て 出力 ュー1 で 作成 され る EXB フ ァイル な ど ) 


エク スク ルー シ プ デ ー タ を 出力 する 場合 の デバ イス 名 は 、"MIDIAE' ま た は 
"MIDIBE' で 行っ て くだ さい 。 
(FO'F7' の チェ ッ ク を 行い 、 受 信 側が オー バー フロ ー を お こさ な いよ うに 
ウェ イト を 挿入 し ます 。) 


借 FM 音 源 プ MIDI プ ADPCM を 、 任 意 の チャ ン ネ ル (1 一 25) に 割り 当て て 鳴ら すこ と が で き 
作 す 。 


価 ADPCM 音 を 128 種 類 ま で 登録 する こと が で きま す 。 
(MML 中 で は 任意 の ノー ト に 割り 当て て 記述 で きま す 。) 


信 ト ラッ ク 数 は 80 で 、25 ト ラッ ク ま で 同時 演奏 する こと が で きま す 。 
信 1 トラ ッ ク で 和音 を 演奏 する こと が で きま す 。 (MIDI の み ) 


⑱@ モ ジュ レー ショ ング ピッ チ ベ ン ド の コマ ンド は 、 そ の まま FM 音源 に 対し て も 機能 し ま 
まぁ 。 


信 常 に MIDI ク ロッ ク (F8) を 出力 し て いる の で 、 外 部 シー ケン サー を 同期 演奏 させ る こと 
の GO ま あら 
外部 同期 に 設定 すれ ば 、 外 部 シー ケン サー で コン トロ ー ル する こと も で きま す 。 
任意 の 小節 で の スタ ー ト プス トッ プ が 可能 で す 。 
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2。 3 GOPMIARVS 


免 SOUND SX-68K、SOUND PRO-68K の SND フ ァイル で 音色 設定 が で きま す 。 
(音色 名 も その まま 登録 され ます 。) 


人 @ MML デ ー タ の 中 に チャ ン ネ ル 変 更 コ マン ド を 自由 に 設定 で きま す 。 


信 MUSIC PRO-68K [MIDI] の MUS フ ァイル を その まま 演奏 で きま す 。 
(オプ ショ ンス イッ チノ Y を 設定 し て くだ さい 。 ) 


人 WOPMDRV3.X 上 で MUSIC PRO-68K、MUSIC PRO-68K [MIDI] が その まま 利用 で きま 
す 。 (オプ ショ ンス イッ チノ A を 設定 し て くだ さい 。) 
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和 ま 放 K 信 オプ ンション スイ ッ チ 
OPM ド ライ バ 3 (OPMDRV3.X) で は 登録 時 に 以下 の オプ ショ ンス イッ チ を 設定 で きま 
す 。 


n に トラ ッ ク バ ッ フ ァ の サイ ズ を 1K バ イト 単位 で 指定 し ます 。 
指定 範囲 は 24 バ イト ー4096k バ イト で 、 省 略し た 場合 は 64K バ イト を 確保 し 
ます 。 

( 例 : OPMDRV3 #120 ) 
n に PCM デ ー タ の バッ ファ サイ ズ を KK バイ ト 単 位 で 指定 し ます 指定 範囲 は 
Ok 介 ー4096k/" 介 で 省略 し た 場合 は 24K バ イト を 確保 し ます 。 
ADPCM を 使用 し な い 場 合 は n に 0 を 指定 し て くだ さい 。 

( 例 : OPMDRV3 /P200 ) 
MML デ ー タ の Y コ マン ド の モー ド を 指定 し ます 。 デ フォ ルト は /Y1 に 設定 さ 
叶 5 ボ あら 

( 例 : OPMDRV3 /Y0 /MOP ) 
MUSIC PRO-68K [MIDI] の MUS77 人 を 演奏 時 の 設定 
各 音 源 に 対す る チャ ン ネ ル 番 号 を 指定 し ます 。 
省略 し た 場合 は 、/OPM の 設定 に な り ま す 。 

( 例 : OPMDRV3 /OPM ) 


OOPM (使用 チャ ン ネ ル 数 8 : ch ニニ 1 一 8) 


MーMIDI (使用 チャ ン ネ ル 数 16 : ch 三 9 一 24) 
PーPCM (使用 チャ ン ネ ル 数 1 : ch 三 25) 


アル ファ ベッ ト で 指定 され た 順に 、 各 音源 で 使用 する チャ ン ネ ル 番 号 を 割り 
当て ます 。 

上 記 の 場合 は 、OPMーch1 一 8 MIDI ニ ch9-24 PCM 三 ch25 が それ ぞ れ の 音 
源 に 対す る チャ ン ネ ル 番 号 と な り ま す 。 


MIDI を 使用 し な い 場 合 は /OPM と 指定 し て お け ば 、 従 来 の MML デ ー タ を そ 
の まま 演奏 で きま す 。 
(OPM=ch1-8 PCM 三 ch9 MIDI 三 ch10 一 25) 


MIDI に 指定 され た ch は 、 そ の 範囲 を MIDIch1 一 16 に シフ ト し て MIDIOUT に 
出力 され ます 。 り OPM' で ch10 一 25 が 指定 され て いる 場合 は 、ch10 が MIDIch1 
に 、ch25 が MIDIch16 に な り ま す 。 


これ ら の 設定 は 、 起 動 後 に も 変更 する こと が で きま す 。 
(BASIC 上 で は m_sysch0 コマ ンド で 、OS 上 で は (/OPM) な ど で 変 更 ) 
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2. 3 OPMDRV 3 


FM 音源 全体 の 音程 を 微 調整 し ます 。(Q=0 一 63) 7 ルト は 0 


OPMDRV3.X を 解除 し ます 。 


MUSIC PRO-68K [MIDI] を 使用 する と き に 設定 し ます 。 


名 スイ ッ チ を 省略 し た 場合 の デフ ォ ル ト は #64 /OPM /Y1 /P24 と な り ま す 。 
人 @MUS フ ァイル を 演奏 する 場合 は 次 の よう に 指定 し て くだ さい 。 

MIDI コ ント ロー ル デ ー タ 出力 モー ド 
DEVICE = \SYS\OPMDRV3.X #120 /MOP /Y0 


曽 、 そ れ ぞ れ の 曲 デ ー タ の 先頭 に 以下 の OPM コ マン ド を 追加 記入 し て お け ば 、 上 記 の 選 
択 は 不要 に な り ま す 。 (「2-3-50PM コ マン ド 」 を 参照 ) 


OPM フ ァイル を 演奏 する 場合 (/OPM)(/Y1) 


MUS フ ァイル を 演奏 する 場合 (/MOP)(/YO) 
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の ま K を 称 還 拡張 MML 書 式 
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OPMDRV3.X で は 次 の MML が 拡張 され て いま す 。 
その 他 の MML に つき まし て は 、「X-BASIC ユー ザー ズリ ファ レン ス | を ご 覧 くだ さ 
い 。 

(OPMDRV2.X で 拡張 され た MML は 使用 で きま せん 。) 


MML デ ー タ パラ メー タ 範 囲 (初期 値 ) 
mー1ー25 


[em | バン ボット の 衣 定 | m=0 お 125) 
ボリ ュー ム の 設 
[eb | タッパ ー ォ シオ フ 2 設 定 | im=0GDiGD 
im=0 8192 一 16363( 音 689 


@Bn1.n2 ピッ チ ベ ン ド の 設定 type 2 :n1 三 0 一 127(low byte) 
:n2 三 0 一 127(hi byte) 


モジ ュ レ ーション の 設定 :n1 三 0 一 127(depth) 
n2 を 省略 し た 場合 は 198 :n20 一 2SS(speed) 
(speed は FM 音源 の み に 有 効 ) 
和音 の 指定 : 最 初 の 音程 の み 長 さ を 指定 可 : 異 な る 長 さ の 音 は 混在 不 
可 。 最大 8 音 (> く #ー 十 は 設定 可 ) 

(ドラ ム の パー ト な ど を 1 トラ ッ ク で すま すこ と と が で きま す 。) 
MIDI 以 外 の チャ ン ネ ル で は 和音 演奏 は で きま せん 。 

例 C8EG く C>: 


MUSIC PRO-68K[MIDI] の MUS フ ァイル を 演奏 する 場合 は 必ず 、 
(/MOP)/YO0) の モー ド で 行っ て くだ さい 。 
m_alloc 関 数 また は (M) コ マン ド で 確保 する メモ リサ イズ は 従来 の 1 .2 倍 位 
に 設定 し て くだ さい 。 
も し 演奏 が お か し く な る 場合 は 、m _tk 関 数 実行 後に m_use/m_free 関数 で 
メ モリ 使用 状況 を 確認 し 、 新 た に 設定 し な お し て くだ さい 。 


2. 3 OPMDRV 3 


まま を 5 人 OPM コ マン ド 


以下 の OPM コ マン ド は 、Human68K 上 か ら デ バイ ス 名 OPM' ま た は 'MIDI ' に 直接 出力 し て 
実行 する こと が で きま す 。 


具体 的 に は 、MML と と も に アス キー ファ イル と し て 作成 し て お き 、 
COPY < ファ イル 名 > OPM [ 過 | 
COPY < ファ イル 名 > MIDI Jl 


で 宝 和 で き ます 。 


(REM) ま た は / | "(REM)" ま た は "で 始ま る 行 を 注釈 行 と みな し ます 。 
(全角 文字 で 始ま る 行 も 注釈 と みな し ます 。) 


各 音源 に 対す る チャ ン ネ ル 番 号 の 割り 当て を 変更 し ます 。 
ドラ イ バ 組 み 込 み 時 の オプ ショ ンス イッ チ ("OPM",/POM" な ど ) と 同じ 機 
通 で す 。 

:OPM ch1 一 8 PCM 三 ch9 MIDI 三 ch10 一 25 

:OPM 三 ch1 一 8 MIDI ニ ch9-24 PCM ニーch25 

:MIDI 三 ch1 一 16  OPM 三 ch17ー24 PCM 三 ch23 

:MIDI 王 ch1 一 16 PCM 三 ch17 OPM 三 ch18 一 25 

:PCM 三 ch1 MIDI 三 ch2 一 17 。OPM ch18 一 25 

:PCM ch1 OPM 三 ch2-9 MIDI ニ ch10 一 25 

(ch1 一 223 は チャ ン ネ ル 1 一 チャ ン ネ ル 25 を 示し ます 。) 


MUSIC PRO-68K [MIDI] で 作成 され た "一 .MUS' フ ァイル を 演奏 する 場合 
は (YO0) を 指定 し て くだ さい 。 そ の 他 の 場合 は (/Y1) を 指定 し て くだ さい 。 
デ 7 ルト は (/Y1) に 設定 され て いま す 。 


(/Pn,filename) :n ニ ノー ト 番 号 (0 一 127) 
人 iename で 指定 され た PCM デ ー タ の ファ イル を 読み 込み 、n 番 の ノー ト 
番号 に 登録 し ます 。 フ ァイル 名 は フル パス 名 で 指定 し て くだ さい 。 


ファ イル 名 は その まま PCM の 音色 名 と し て 登録 きれ ます 。 


(/An,tonename) | :n ニ ノー ト 番 号 (0 一 127) 
n 番 の ノー ト 番 号 に PCM の 音色 名 を 登録 し ます 。 


(/S,filename) SOUND SX-68K、SOUND PRO-68K の "一. SND' ファ イル (また は (/SV, 
filename, n) で 作成 され た ファ イル ) を 読み 込み 、FM 音 源 に 登録 し ます 。 
ファ イル 名 は フル パス 名 で 指定 し て くだ さい 。 拡張 子 '.SND' は 不要 で す 。 


FM 音源 の 音色 名 も 同時 に 登録 し ます 。 


85 


第 2 草 バー ジョ ン 3.0 シス テム 


(QV,filename, | :n 三 音色 番号 (1 一 200) 

nl n2..n3.n4 一 n5】 SOUND SX-68K、SOUND PRO-68K の "一 .SND' フ ァイル の フォ ー マ ッ ト 
で 現在 登録 され て いる 音色 デー タ の 内 、n で 指定 され た 音色 デー タ を ファ 
イル に 保存 し ます 。 フ ァイル 名 は フル バス 名 で 指定 し て くだ きい 。 ファ 
イル 名 に 拡張 子 '.SND' は 不要 で す 。 

n を 省略 し た 場合 は 200 音 色 全 て ファ イル に 登録 し ます 。 

例 ) (SV,TEST1.1 一 8.20 一 30,180 一 ) 

音色 番号 1 一 8.20 一 30,180 一 200 の 音色 デー タ を TEST1.SND の ファ イル 名 
で ファ イル に 保存 し ます 。 


(/Vn,tonename) | :n 三 1 一 200 
FM 音源 の 音色 名 を 登録 し ます 。 


ーー0 一 255 ⑦ 7 ルト は 198) 
FM 音源 の LFO (モジ ュ レ ーション ) の 変化 する 速 さ を 設定 し ます 。 
(Ln) で デフ ォ ル ト に 設定 され ます 。 


:nー0off n 三 1on(7 7 ト は 1) 
FM 音源 に 設定 する 音色 パラ メー タ の 内 、LFO プ PMD/AMD な どの 全体 
に 影響 する パラ メー ー タ を 音色 切り 替え 時 に セッ ト す る か どう か を 選択 し 
ます 。 

全て の チャ ン ネ ル に 対し て モジ ュ レ ーション を 正常 に 機能 きせ る 為 に 
は 、n に 0 を 指定 し て お いて くだ さい 。 


:n 三 0 一 127 ⑦ 7 ルト は 127) 
0 ボリ ュー ム を 設定 し ます 。(In) を 実行 する まで 有効 で す 。 
音 に 対し て は 無効 で す 。 


PCM バ ッ フ ァ を クリ ア し ます 。 


xn 三 0 or 1 
トラ ッ ク デ ー タ を 初期 化し ます 。(M ts) も 初期 化 さ れ ま す 。 
各 ト ラッ ク バ ッ フ ァ は 4 バイ ト に 設定 され ます 。 

n 三 0 また は 省略 し た 場合 は 音色 デー タ を 初期 化し ませ ん 。 
n 三 1 で 音色 デー タ も 初期 化し ます 。 


:n1 三 音色 番号 (1 一 200) 

:n2 三 書き 換え を 始め る パラ メー タ 番 号 (0 一 54) 

:dm 三 音色 パラ メー タ (0~255) 

FM 音源 の 音色 を 設定 し ます 。 

n2 は パラ メー タ の 何 番 か ら 書 き 換 える か を 示し て いま す 。 


(V nl.n2,d1.d2.. 
"dm・・dS55 一 n2) 


(D n1n2) 
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:n1 ニ コピ ー 元 の 音色 番号 (1 一 200) 
:n2 ニ コピ ー 先 の 音色 番号 (1 一 200) 
FM 音源 の n1 番 の 音色 を n2 番 に コピ ー し ます 。 


2. 3 OPMDRV 3 


ニート ラッ ク 番号 s ニ パッ ファ サイ ズ 


トラ ッ ク バ ッ フ ァ を 確保 し ます 。 
{を 省略 する と 全て の トラ ッ ク に s を 設定 し ます 。 
(DD で デフ ォ ル ト ( 全 トラ ッ ク 4 バ イト ) に 設定 され ます 。 
確保 し た バッ ファ 容量 が 不足 し て いる と 、 正 常に 演奏 され な い 場 合 が あり 
ます 。 
(M,T,S) コ マン ド で エラ ー が 起き た 場合 は 、 そ の 時 点 で の 確保 可能 な 最大 
値 を 設定 し ます 。 
本 還 
|(OD 。。。 | mn ニテ ン ポ デ ー タ 2②0300) テン ポ を 設定 し ます 。 
am1 ニ 分 子 n2= ニ 分 母 拍子 を 設定 し ます 。 
(T n) MMLdata.…| :m ニ トラ ッ ク 番 号 (1 一 80) 
指定 の トラ ッ ク に MML デ ー タ を 書き 込み ます 。 
(E nl1.n2,..n23) 
n で 指定 され た チャ ン ネ ル の 音声 出力 を 許可 し ます 。 
n で 指定 され た チャ ン ネ ル 以 外 の チャ ン ネ ル は 音声 出力 が 禁止 さき ん て いま 
す 。 (内 部 的 な 演奏 は 継続 し て いま す ) 
n が すべ て 省略 され た 場合 は すべ て の チャ ン ネ ル の 音声 出力 が 許可 きれ ま 
9 
(P nln2,..n25) | :n ニ チャ ン ネ ル 番 号 
n で 指定 され た チャ ン ネ ル の 演奏 を 開始 し ます 。 
n が すべ て 省略 され た 場合 、 全 て の チャ ン ネ ル の 演奏 を 開始 し ます 。 
軸 請 織 
前 


(W nl.n2,..n23) 


:c 三 チャ ン ネ ル 番 号 t 王 トラ ッ ク 番 号 

チャ ン ネ ル c で 演奏 する トラ ッ ク 番 号 を 指定 し ます 。 

c が 重複 し た 場合 は 後 か ら 指 定 し た # ャ ッ に 設定 され ます 。 

{が 重複 し た 場合 は 複数 の # れ > で 同じ トラ ッ ク が 演奏 され ます 。 


:n 三 チャ ン ネ ル 番 号 (1 一 25) 


:n ニ チャ ン ネ ル 番 号 
n で 指定 され た チャ ン ネ ル の 演奏 を 停止 し ます 。 
n が すべ て 省略 され た 場合 、 全 て の チャ ン ネ ル の 演奏 を 停止 し ます 。 


:n 三 チャ ン ネ ル 番 号 
n で 指定 され た チャ ン ネ ル の 演奏 を 再開 し ます 。 
n が すべ て 省略 され た 場合 、 全 て の チャ ン ネ ル の 演奏 を 再開 し ます 。 


:n 王 チャ ン ネ ル 番 号 

n で 指定 され た チャ ン ネ ル が 終了 する まで 待ち ます 。(ESC キ ー ま た は 
BREAK キ ー で 中 止 し ます 。) 

n が すべ て 省略 され た 場合 、 全 て の チャ ン ネ ル の 演奏 が 終了 する まで 待ち 
ます 。 
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(PM n) :mー 小 節 番 号 
演奏 を 開始 する 小節 番号 を 指定 し ます 。 


(Sn) ま た は 演奏 終了 で 解除 され ます 。 
(Qn1.n2) で 曲 の 拍子 が 設定 きれ て いな けれ ば 正常 な 演奏 が で きま せん 。 
また 、 全 トラ ッ ク に お いて 、MML デ ー タ 5 由 [D.S] "7 [D.C] " 
" [$] "な どの 数 が 同じ で な けれ ば な り ま せん 。 
:n 三 小節 番号 

1 

に 主 

に 較 


演奏 を 停止 する 小節 番号 を 指定 し ます 。 
(S n) ま た は 演奏 終了 で 解除 きれ ます 。 
| 


(O n1n2) で 曲 の 拍子 が 設定 され て いな けれ ば 正常 な 演奏 が で きま せん 。 
また 、 全 トラ ッ ク に お いて 、MML デ ー タ | [DS] "7 [D.C] " 

" [$] "な どの 数 が 同じ で な けれ ば な り ま せん 。 
Jo) :c 三 チャ ン ネ ル 番 号 (1 一 25) 

指定 の チャ ン ネ ル へ オー ルノー ト オ フ を 出力 し ます 。 

c を 省略 し た 場合 は 全て の チャ ン ネ ル に オー ルノー ト オ フ を 出力 し ます 。 
X nln2,…nS512)| n1 一 nm まで の デー タ を MIDI へ 直接 出力 し ます 。 

指定 で きる デー タ の 数 は 512 個 まで で す 。 
ュ ニ 0 内 部 同期 n ニ 1 外部 同期 n ニ 2 FSK 同 期 
P) MIDI の スタ ー ト コー ド ($FA) を 出力 
MIDI の スト ッ プ コー ド ($FC) を 出力 
MIDI の コン ティ ニュ ー コ ー ド ($FB) を 出力 


常に MIDI ク ロッ ク ($F8) を 出力 し て いる の で 、 外 部 シー ケン サー と 同期 
演奏 させ る こと が で きま す 。 


:c ニ チャンネル 番号 (1 一 25) n 三 出力 チャ ン ネ ル 番 号 (1 一 25) 
一 時 的 に 出力 チャ ン ネ ル を 変更 し ます 。 
(In) で 元 に 戻り ます 。 


.c ニ チャ ン ネ ル 番 号 n 三 音色 番号 (OPM:1 一 200 MIDI:1 一 128) 
指定 の チャ ン ネ ル に 音色 番号 を 設定 し ます 。 


:c 三 チャ ン ネ ル 番 号 n テ ボリ ュー ム デ ー タ (0 一 127) 
指定 の チャ ン ネ ル に ボリ ュー ム デ ー タ を 設定 し ます 。 


:c ニ チャンネル 番号 n ニ パン ポッ ト デ ー タ (0 一 127) 
指定 の チャ ン ネ ル に パン ポッ ト デ ー タ を 設定 し ます 。 


:c ニ チャンネル 番号 n テ ベロ シテ ィ デ ー タ (0 一 127) 
指定 の チャ ン ネ ル に ベロ シテ ィ デ ー タ を 設定 し ます 。 


:c 三 チャ ン ネ ル 番 号 n テ トラ ンス ポー ズ デ ー タ (0~48) 
指定 の チャ ン ネ ル に トラ ンス ポー ズ デ ー タ を 設定 し ます 。 
土 2477-7'′ の 範囲 で 半音 ずつ 音程 を シフ ト し ます 。(⑰ 7# ル ト は 24) 


cc 三 チ ャ ン ネ ル 番 号 nn 三 コ ント ロー ルコ ー ド n2 ニ デー タ 
指定 の チャ ン ネ ル に コン トロ ー ル デー タ を 出力 し ます 。 


で )) 
(⑥) 
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追加 ライ ブラ リ 


拡張 DOS コ ー ル ライ ブラ リ 
拡張 )OCS コ ー ル ライ ブラ リ 
OPMDRV3 ラ イブ ラリ 
上 較 ライ ブラリ 
SC81 ラ イブ ラリ 


拡張 DOS コ ー ル ライ ブラ リ 


と と で は Human68kver.3.0 で 新規 に 追加 、 も し く は 拡張 され た DOS コ ー ル ライ プラ リ を 説 
明 し て いま す 。 

従来 の DOS コ ー ル の $EFFS0 か ら $FF7F ま で は 、MPU68030 で は cpRESTORE 命 令 と 判断 さ 
れ 、 ア ドレ ッ シ ン グ に よっ て は F 系 列 の 未定 義 処理 に いく 前 に バス エラ ー を 起こ すこ と が 
あり ます の で 、 同 じ 処理 を $FF80 か ら $FFAF で も 実行 で きる よう に し て いま す 。 

ユー ザー モー ド で 動作 する 場合 に は 、 こ れ ら の コー ル は バス エラ ー の 前 に 特権 違反 が 先 
に 発生 する た め 、$FES0 か ら $FF7F で も 正しく 処理 され ます が 、 ス ー パ ー バ イザ ー モ ー ド 
で 動作 し て いる 場合 は その と き の レ ジス タ の 値 に より バス エラ ー が 発生 し た り し な か っ 
た り し ます の で 、 で きる だ け $FF80 か ら $FFAF を 使用 する よう に し て くだ さい 。 


その た め 新 し く DOSINTT( ) 関 数 が 、"CLIBL" に 用 意 さ れ て いま す 。 各 DOS コ ー ル を 呼ぶ 
前 に 、 こ の 関数 を コー ル す る こと に より 、 ど の バー ジョ ン の OS で も 新しい DOS コ ー ル 番 
号 で 使用 する こと が 可能 と な り ま す 。 

_ MAIN.O か ら 始 まる プロ グラ ム で な い めい 通常 の アセ ンプ ラプ ログ ラム を 書く 場合 で 、 
スー パー バイ ザー モー ド で 参照 関数 を アク セス する 可能 性 が ある と き は 、 必 ず こ の 関数 
を コー ル し た 後 で 使用 する よう に し て くだ さい 。 


仙 ラ イブ ラリ 一覧 (アル ファ ベッ ト 順 ) 


較 | 」 
名 前 機 能 貞 
BREAKCK プレ ー ク チェ ッ ク の 設定 | 9 
CLOSE ファ イル ハン ドル の クロ ー ズ 95 
CREATE ファ イル の 新規 作成 96 
DOSINIT DOS コ ー ル の 処理 さ ク タタ の コピ ー 97 
EXFILES ファ イル の サー チ 98 
EXNFILES 次 の ファ イル の サー チ 99 
FFLUSH_SET FFLUSHO の 有効 ・ 無 効 の 制御 100 
GET FCB_ADR FCB の アド レス を 得る 101 
IOCTRLFDCTL デバ イス ドラ イ バ に よる 特殊 コン トロ ー ル 103 
MALLOCO 指定 メモ リ 領 域 を 確保 し ポイ ンタ を 返す 105 
OS_PATCH FASTIOJFASTOPEN.FASTSEEK の 制御 106 
S_MALLOCO 指定 メモ リ 領 域 を メイ ン か ら 確 保 し ポイ ンタ を 返す | 107 
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3. 1 拡張 DOS コ ー ル ライ ブラ リ 


BREAKCK 
#jinclude ぐ doslib.h> 


int BREAKCK(flag): 
int flag: / ま プレ ー ク チェ ッ ク の 設定 フラ グ */ 


プレ ー ク チェ ッ ク の 設定 と 、 各 コン トロ ー ル コー ド の 設定 を 行い ます 。 
flag に 指定 で きる 内 容 は 次 の 通り で す 。 各 値 は 、"DOSLIB.H" に 定義 され て いま 
す 。 


BREAKCK_OFF ・ 特 定 の ファ ンク ショ ンコ ー ル で の み チ ェ ッ ク す る 。 
(BREAK=OFF) 

BREAKCK_ON ・ す べ て の ファ ンク ショ ンコ ー ル で チェ ッ ク す る 。 
(BREAK=ON) 

BREBAKCK KITITL。 : す べ で の ファ ンク ショ ンコ ー ル で チェ ッ ク し な い 。 


(BREAK=KILL) 
BREAKCK CHECK  : 設定 状態 が OFF(0) か ON(1) か KILL(2) か を 調べ る 。 


これ ら の 機能 に 加え て 、Human68k ver.3.0 以 後 で は 、 以 下 の 設定 が 可能 で す 。 
これ は 、CTRL+C PIN,Q,S の 各 機 能 を ON/OFF す る た め の も の で 、OFF に する と 
その コー ド は 通常 の キー 入力 で 読め る よう に な り ま す 。 

バー ジョ ンチ ェ ッ ク し て か ら 使 用 し て くだ さい 。 


CTRL 一 C CHECK  :CTRL+C お よび BREAK の 内 部 処理 が ON(1) か OFF(O) か 


を 調べ る 。 

CTRL 一 C_ ON ・CTRL+C お よび BREAK の 内 部 処理 を する モー ド に 変更 
する 。 

CTRL 一 C OFF ・CTRL 二 C お よび BREAK の 内 部 処理 を し な いで コー ド を 


返す モー ド に 変更 する 。 


CTRL 一 N CHECK  :CTRL+N の 処理 が ON(1) か OFF(0) か を 調べ る 。 


CTRL 一 N_ON ・ CTRL 二 N の 内 部 処理 を する モー ド に 変更 する 。 

CTRL 一 N_OFF ・CTRLT+N の 内 部 処理 を し な いで コー ド を 返す モー ド に 
変更 する 。 

CTRL 一 P CHECK  :CTRL+P の 処理 が ON(1) か OFF(0O) か を 調べ る 。 

CTRL 一 P_ON ・ CTRL 十 P の 内 部 処理 を する モー ド に 変更 する 。 

CTRL 一 P OFF ・CTRL+P の 内 部 処理 を し な いで コー ド を 返す モー ド に 
変更 する 。 
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CTRL-Q_CHECK 


・CTRL 十 OQ の 処理 が ON(1) か OFF(0) か を 調べ る 。 


CTRL 一 Q_ON ・CTRL 寺 Q の 内 部 処理 を する モー ド に 変更 する 。 

CTRL 一 Q_OFF ・ CTRL 十 Q の 内 部 処理 を し な いで コー ド を 返す モー ド に 
変更 する 。 

CTRL 一 S_CHECK :CTRL 十 S お よび SHIFT 十 BREAK の 処理 が ON(1) か 
OFF(0) か を 調べ る 。 

CTRL-S_ON ・ CTRL 十 S お よび SHIFT 士 BREAK の 内 部 処理 を する モー 
ド に 変更 する 。 

CTRL 一 S_OFF ・ CTRL 十 S お よび SHIFT 十 BREAK の 内 部 処理 を し な いで 
コー ド を 返す モー ド に 変更 する 。 

設定 状況 を 表す 次 の 値 を 返し ます 。 

BREAKCK_ OFF  : 特 定 の ファ ンク ショ ンコ ー ル で の み チ ェ ッ ク す る 。 
(BREAKOFF) 

BREAKCK ON  : す べ て の ファ ンク ショ ンコ ー ル で チェ ッ ク す る 。 


BREAKCK KILL 


(BREAK 三 ON) 


・ すず スペ で の ファン クシ ョ ジコ ロー ル で チュ ェ ッ ク し な い 。 


(BREAK 三 KILL) 


3. 1 拡張 DOS コ ー ル ライ ブラ リ 


CLOSE 
jinclnde doshibh> 


int CLOSE(fileno): 
int fileno: / ネ ファ イル ハン ドル ※*/ 


機 能 | Rino で 指定 する ファ イル ハン ドル を クロ ー ズ し ます 。 
Human68k ver.3.0 以 隆 で は 、DUP.DUP2 し て 作成 され た ファ イル を クロ ー ズ す 
る と き に 、 フ ァイル 長 そ 更 新 日 時 の 書き 込み を 行う よう に な り ま し た 。 


戻り 値 | 正 の 数 (0 も ) で 正常 終了 、 負 の 数 (一 1 以外 も $) で エラ ー。 


通常 は 0 が 返り ます が 、 特 殊 デ バイ ス ド ラ イ バ が 対象 の と き は 、 0 以外 の 正 の 
数 の 場合 が あり ます 。 


DuPpum 
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CREATE レベ ル 1 機能 追加 


書 式 


機能 
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#include ぐ く doslib.h> 


int CREATE(file,atr): 
unsipgned char 玉 file: /* ま ファ イル 名 格納 領域 へ の ポイ ンタ 玉 / 
int ar /* ファ イル 属性 */ 


ファ イル を 新規 に 作成 し ます 。 ar に は 、 次 の ファ イル 属性 を 指定 し ます 。 
ビッ ト 0m8 


Ox01 = 読み 込み 専 
Ox02 = 隠し ファ イル 組み 合わ せ で 0 一 7 まで 指定 で きま す 。 


Ox04 ニ シス テム ファ イ /) 

0x08 ニ ボリ ュー ム I この 3 つの うち どれ か 1 つ を 指定 し 
Ox10 = ニ ディ レク トリ | て 0-7 の 組み 合わ を と 加 人 れ 
0x20 = 通常 ファ イリ 値 を 指定 し ます 。 


ビッ ト 15 : 1 の 場合 、 指 定 の ファ イル が ある か どう か チェ ッ ク し な いで ファ イ 
ル を 新規 作成 し ます 。 
CONFIG.SYS フ ァイル で の コマ ンド 、DIRSCH=ON 状 態 を より 高 
速 化し た い 場 合 に 使用 し て くだ さい 。 
た だ し 存在 する ファ イル 名 を 指定 し た 場合 、 別 ファ イル と し て 作 
成す る た め 、 フ ァイル が 2 個 存 在 す る よう に な っ て し まい ます 。 


この 機能 は 、Human68k ver.3.0 以 後 で す サポ ー ト され て いま す 。 Human68K の 
バー ジョ ン を チェ ッ ク し て か ら 使 用 し て くだ さい 。 


ファ イル ハン ドル の 値 を 返し ます 。 
負 の 数 な ら ば 、 エ ラー コー ド を 示し ます 。 


3. 1 拡張 DOS コ ー ル ライ ブラ リ 


LDPOSINIIーーーーーー バ ーーー て yz ] 


void DOSINIT( ): 


参照 関数 に 明記 し た 関数 を 、Human68k ver.2.0 以 前 の OS で も 使え る よう に 、 
DOS コ ー ル の 処理 ベクタ を コピ ー し ます 。 

DOS コ ー ル の $EFF50 か ら $FF7F ま で は 、MPU68030 で は cpRESTORE に 割り 当て 
られ 、 コ プロ セッ サ の アク セス の 前 に 実効 アド レス の アク セス が あり ます の 
で 、 も し 実効 アド レス 先 で エラ ー と な る と DOS コ ー ル は 実行 さま れ ま せん 。 こ 
れ に 対処 する た め に 、Human68kver.3.0 で は これ ら の DOS コ ー ル を それ ぞ れ 、 
$FF80 か ら $FFAF に 移動 し て いま す 。 

各 DOS コ ー ル を 呼ぶ 前 に この 関数 を 呼 尽 こ と に より 、 ど の バー ジョ ン の 
Human68k で も 、 新 し い ラ イブ ラリ を 使用 する こと が 可能 と な り ま す 。 

C で 通常 の 使い 方 を する 場合 に は 、main( ) 関 数 が 始ま る 前 に _ _main の 中 で 
DOSINIT( ) を コー ル し て いま す の で 、 プ ログ ラム 中 で コー ル す る 必要 は あり 
ませ ん 。 

__MAIN.O か ら 始 まる プロ グラ ム で な い めい 通常 の アセ ンプ ラプ ログ ラム を 書く 
場合 で 、 ス ー パ ー バ イザ ー モ ー ド で 参照 関数 を コー ル す る 可能 性 が ある と き 
は 、 必 ず こ の 関数 を 呼び 出 し た 後 で 使用 する よう に し て くだ さい 。 

な お この 関数 を コー ル せ ず に 、 参 照 関数 を 使用 し た 場合 の 動作 保証 は で きま 
せん 。 ま た 、 こ の 関数 は "CLIBL" に 含ま れ て いま す 。 

な お 、 こ の 関数 は ヘッ ダフ ァイル に は 登録 され て いま せん 。 


戻り 値 は あり ませ ん 。 


DOSLIB.L 
SETPDB, GETPDB, SETENV, GETENV, VERIFYG, COMMON_CK, 
COMMON_RD, COMMON_WT, COMMON_LK, COMMON_FRE, 
COMMON_DEL, MOVE, RENAME, FILEDATE, MALLOC2, MAKETMP, 
NEWFILE, LOCK, UNLOCK, MAKEASSIGN, GETASSIGN, RASSIGN, 
FFLUSH_SET,OS_PATH, GET_FCB_ADR,S_MALLOC, S_MFREE, 
S_PROCESS 


CLIB.L 
rename,fstat,getft,chgftLutime 


BASLIB.L 
b_ abortufrename 
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ニー ター: 
nclude ぐ doslib.h> 


int EXEFILES(buffer,file,atr): 

struct EXFILBUF buffer: /* ファ イル 情報 格納 領域 へ の ポイ ンタ */ 
unsigned char file: /* ファ イル 名 格納 領域 へ の ポイ ンタ */ 
int ar / 率 ファ イル 属性 */ 


struct EXFILBUF [ 
UBYTE os [21] : /*Human68K が 内 部 で 使用 、 変 更 不可 */ 


UBYTE afr: 
UWORD time: 
UWORD date: 
UINT filelen: 


UBYTE name [23] : 

UBYTE drive [2] : /* ドラ イブ 名 文字 列 "A:" 形 式 */ 

UBYTE path [65] : /* パス 名 文字 列 "\test\" 形 式 */ 

UBYTE exos [21] : /*Human68K が 内 部 で 使用 、 変 更 不 可 */ 
絆 


file で 指定 され 、ar の 属性 を も ね る つ フ ァイル を サー チ し て 、 そ の 情報 を buffer へ 
格納 し ます 。 フ ァイル 名 に は 、EXNFILES で 次 の ファ イル を サー チ す る こと が 
で きま す 。 ar に 指定 する 属性 は 次 の 通り で す 。 


0x01 三 読み 込み 専用 
0x02 = 隠し ファ イル 
0x04 ニシ ステ ム フ ァ イル 
0x08 ボリ ュー ム JD 
0x10 三 ディ レク トリ 
0x20 = 通常 フ ァイル 


EXFILBUF 構 造 体 は 、FILBUF 構 造 体 に 対し て 、drive,path が 追加 され 、 か つ 
チェ ッ ク の た め の フ ァイル 名 バッ ファ を 8 十 3 文 字 だ け で な く 8 十 3 十 10 文 字 分 
も っ て いま す 。 EXFILES を と っ た 場合 は 、 必 ず 同 じ 構 造 体 で EXNFILES を 呼 
ぶよ う 、 ご 注意 くだ さい 。 この 関数 は 、Human68k ver.3.0 以 後 で す サポー ト さ れ 
て いま す 。 Human68K の バー ジョ ン を チェ ッ ク し て か ら 使 用 し て くだ さい 。 


戻り 値 | 終了 コー ド を 返し ます (正常 終了 の と き は 0 を 返し ます ) 。 
BkNmrEs 
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EXNFILES 昌 
jinclude ぐ doslib.h> 


int EXNFILES(buffer): 
struct EXFILBUF 玉 buffer: / キ ファ イル 情報 格納 領域 へ の ポイ ンタ */ 


struct EXFILBUF [ 
UBYTE os [21] :  /*Human68K の 内 部 で 使用 、 変 更 不可 */ 


UBYTE afT: 

U り WORD time: 
UWORD date: 
UINT filelen: 


UBYTE name [23] : 

UBYTE drive [2] : /* ネ ドラ イブ 名 文字 列 "A:" 形 式 */ 

UBYTE path [65] : /* パス 名 文字 列 "\tes\" 形 式 ネ / 

UBYTE exos [21] : /*Human68K の 内 部 で 使用 、 変 更 不 可 */ 

機 能 | EXFILES で 得 た buffer を 指定 し て 、 次 の ファ イル を サー チ し ます 。 

EXFILBUF 構 造 体 は 、FILBUF 構 造 体 に 対し て 、drive,path が 追加 され 、 か つ 
チェ ッ ク の た め の フ ァイル 名 バッ ファ を 8 十 3 文 字 だ け で な く 8 十 3 十 10 文 字 分 
も っ て いま す 。 EXFILES を と っ た 場合 は 、 必 ず 同 じ 構 造 体 で EXNFILES を 呼 
ぶよ う 、 ご 注意 くだ さい 。 


この 関数 は 、Human68k ver.3.0 以 後 で す サポ ー ト され て いま す 。Human68K の 
バー ジョ ン を チェ ッ ク し て か ら 使 用 し て くだ さい 。 


戻り 値 | 終了 コー ド を 返し ます 。 
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FE9ST に SE サーーーーー マ ゴゴ cp] 


機 能 
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#include ぐ doslib.h> 


int FFLUSH_SET(flg): 
int flg: /\*FFLUSH 有 効 三 1、 無効 =0 の フラ グ 、 あ る い は 状態 調査 ニー1 */ 


FFLUSH() の 有効 ・ 無 効 を 制御 し ます 。 プ ログ ラム 内 で FEFLUSH() を 使用 し 
て 、 頻 繁 に バッ ファ か ら フ ラッ シュ し て いる と き 、FASTIO, FASTOPEN, 
FASTSEEK な どの 外部 コマ ンド を 常 太 し て いて も 、 高 速 化 が あま り 有 効 で な 
い 場 合 が あり ます 。 

この よう な 場合 は 、 こ の 関数 で FFLUSHO を 無効 に し て お く こ と に より 、 高 束 
化す る こと が で きま す 。 た だ し 、FEFLUSHO) を 実行 し な いこ と は 危険 で す の 
で 、 通 常 の 使用 で は 有効 に し て お いて くだ さい 。 


flg 王 0 :FFLUSHO を コー ル し て も 、 実 行き まれ ませ ん 。 

flg 王 1 :FFLUSHO を コー ル す る と 、 キ ー バ ッ フ ァ の フラ ッシュ と 、 デ ィ 
スク バッ ファ の フラ ッシュ (FASTIO,FASTSEEK,FASTOPEN の 
オプ ショ ン に より ます ) を 行い ます 。 

flg ニ ー1 : 現 在 の 状態 を 調べ ます 。 


この 関数 は 、Human68k ver.3.0 以 後 で す サポ ー ト され て いま す 。Human68K の 
バー ジョ ン を チェ ッ ク し て か ら 使 用 し て くだ さい 。 


fig ニー1 の 場合 は 、 現 在 の 状態 を 返し ます 。flg 三 0 また は 1 の 場合 は 、 設 定 前 の 
状態 を 返し ます 。 


FFLUSH 


3. 1 拡張 DOS コ ー ル ライ ブラ リ 


GET FCB_ADR 間 
nclude て doslibh> 


struct FCBS GET FCB_ADR(hnd): 
int hnd: /* ハン ドラ 番号 */ 


struct FCBS 【 

UBYTE hndcnt  / キ この FCB を 使用 し て いる ハン ドラ の 数 (2 以上 な 
ら DUP さ れ て いま す ) */ 

UBYTE dev_type: / キ ビッ ト 7 が 0 の 場合 は プロ ッ ク デ バイ ス を 表し 、 
他 の ビッ ト の 意味 は 以下 の 通り で す 。 
ビッ ト 6 テ ECB 変 更 フ ラグ (time,date,file_len の ど 
れ か を 変更 し た ら 1) 
ビッ ト 5 ぅ = 特殊 プ ブロック デバ イス な ら 1、 通 常 は 
0 
ビッ ト 4 一 0 は ドラ イブ 番号 を 表し 、A な ら 
00000、Z な ら 11001 
ビッ ト 7 が 1 の 場合 は キャ ラク タデ バイ ス を 表し 
他 の ビッ ト の 意味 は 以下 の 通り で す 。 
ビッ ト 6 三 INPUT_EOF_FLG( 最 終 文字 を 読み 込 
ん だ な ら 1) 
ビッ ト 5 三 RAW デバ イス な ら 1、 通 常 は 0 
ビッ ト 4 ニ 0( 未 使用 ) 
ビッ ト 3 ニ CLOCK デバ イス な ら 1 
ビッ ト 2= ニ NULL デバ イス な ら 1 
ビッ ト 1 三 標準 出力 デバ イス な ら 1 
ビッ ト 0 テ 標準 入 カ デバ イス な ら 1 

ネネ / 

UBYTE *devadr: / キ デバ イス ドラ イ バ ー の 先頭 アド レス (た だ し 
dev_type の ビッ ト 7 テ 1 の 場合 の み 。 ビ ッ ト 70 
の 場合 は 、dpb_adr で 、OSDPBPTR 構 造 体 (OS 内 
部 DPB) の ア ドレス) */ 

UBYTE os work [30] : 

UBYTE namel [8] : /* ファ イル 名 の 先頭 8 文字 し く は デバ イス 


名 */ 
UBYTE ext [3] : /* 拡張 子 */ 
UBYTE at / ネ アトリビュート ※*/ 
UBYTE name2 [10] : /* ファ イル 名 の 残り 10 文 字 */ 
USHORT time: /* ネ ファ イル 変更 時 間 */ 
USHORT date: / ネ * ファ イル 変更 月 日 */ 
USHORT start_fat: /* ファ イル 先頭 FAT ネ / 
long file_len: / ネ ファ イル バイ ト 数 */ 


UBYTE os work2 [28] : 
: 


機 能 | ハン ドラ 番号 か ら 内 部 で 使用 中 の FCB の アド レス を 得 ま す 。 あ くま で も 内 部 の 
FCB で すか ら 不 用 意 に 書き 替 た を な いで くだ さい 。 オ ー プ ン 中 の ファ イル の 名 前 
を 調べ る と き な ど に 、 ご 利用 くだ さい 。 
また 、 こ の アド レス は スー パー バイ ザー 領域 の た め 、 通 常 の アク セス で は バス 
アム ーー ら な り ます :。 
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この 関数 は 、Human68k ver.3.0 以 後 で す ポ ー ト され て いま す 。Human68K の 
バー ジョ ン を チェ ッ ク し て か ら 使 用 し て くだ さい 。 


FCBS 構 造 価 の ポイ ンタ ー を 返し ます 。 あ くま で も 内 部 で 使用 中 の FCB そ の も 
の で ある こと に 注意 し て くだ さい 。 


OPEN.CREATE,DUP.DUP2 
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| 
include <doslib.h> 


機 人 


CC 


int IOCTRLFDCTL(drive,f_code,buffer): 

int drive: /* ドラ イブ 番号 (0 ニ カレ ント 、 1 王 A:) */ 
int fcode: /* ファ ンク ショ ン 番 号 (一 1.0.1.2)  */ 
unsignedchar buffer: /* 装置 情報 の 格納 領域 へ の ポイ ンタ  */ 


ドラ イブ 番号 drive と ファ ンク ショ ンコ ー ド f code、 ま た buffer で 示さ れる 領域 
を 指定 し て 、 デ バイ ス ドラ イ バ に よる 特殊 コン トロ ー ル を 行い ます 。 
Human68k ver.3.0 よ り 2HD と 2HC の ディ スク の 種類 の 認識 が で きる よう に な 
り 、 さ ら に FDDEVICE.SYS を 登録 する こと に より 、2DD の ディ スク タイ プ も 
認識 で きる よう に な り ま し た 。 

これ に より IOCTRLEDCTL を 使用 する こと で 、 フ ロッ ピー ディ スク の フォ ー 
マッ ト 直 後に 、 現在 挿入 され て いる ディ スク タイ プ を 判断 する こと な ど が で き 
各 

な お この 機能 は 、Human68k ver.3.0 以 降 で サポ ー ト され て いま す 。 


f code の 値 に より 、 次 の 処理 内 容 と な り ま す 。 


今 f code 一 1 

buffer が 示す 領域 に 、'DISKdev1' の 8 文字 が 格納 され ます 。 

この 文字 列 が セット され て いれ ば 、 特 殊 コ ント ロー ルフ ァ ン クシ ョ ン が 実行 で 
きる こと を 示し ます 。 


人 @f code 三 0 
buffer が 示す 領域 の 先頭 1 ワー ド に 、 以 下 の メ ディ アバ イト が セッ ト さ れ ま 
売ら 


0x00FO 2HD (1.44MB) 

0x00FB 2DD (512 バ イト X 8 セク タ ) 
0x00FC 2DD (512 バ イト X 9 セクタ) 
0x0OFD 2HC (512 バ イト X15 セ クタ ) 
0xOOFE 2HD (1.2MB) 


で { code 三 1 
buffer が 示す 領域 に 、 以 下 の 装 置 情 報 が セ モット され ます 。 


unsigned int trap15:  / 玉 rap15 の リタ ー ン 値 (DO の 値 ) */ 
unsignedshort bytessec / ま ギ 1 セク タ あ た り の バイ ト 数 */ 
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unsignedchar secfa:: /* 1 クラ スタ あたり の セク タ 数 ※*/ 
unsignedchar fatcoun:: /* FAT 領域 の セク タ 数 */ 
unsignedshort rsv_sec: /* 予約 領域 の セク タ 数 ※/ 

unsigned short dircount: / キ ルー トディ レク トリ に は いる エン トリ 


数 \*/ 
unsignedshort maxfa:  /* 総 ク ラス タ 数 */ 
unsignedchar idi /* メデ イア バイ ト ※/ 


unsignedchar fatsec: /* 1 個 の FAT に 使用 する セク タ 数 */ 

unsigned short sectrack: / ま 1 トラ ッ ク あ た り の セク タ 数 ※*/ 

unsigned short sidecount: / ま ディ スク の 面 数 */ 

unsignedchar pda: /* ディ スク 関係 の IOCS コ ー ル で 使用 する 
PDA の 上 位 8 ビ ッ ト ※/ 

unsignedchar  ejectflag: /* メデ ィ イア 挿 入 チ ェ ッ ク の た め の イ ジェ 
クト フラ グ ギ */ 


人 @f code 三 2 
上 記 し た ejectflg の 値 を 変更 し ます 。buffer に は 格納 領域 へ の ポイ ンタ で は な 
く 、 次 の 値 を セッ ト し て くだ さい 。 


ー1 ニ イ ジ ェクト され た も の と し て BPB と DPB を 再 構築 し ます 。 

0 三 IOCS コ ー ル B_DRVCHK の 返す 値 に し た が いま す 。 

1 ニゴイ 2 クウ ド RS れい が いも の と し じ で 、X ポ ディ アザ ェ ッ ク を 1 
回 無 愉 し ます 。 


戻り 値 | 戻り 値 は 、 デ バイ ス ド ラ イ バ に より 異な り ま す 。 


負 の 数 な ら エ ラー を 表し ます 。 
IOCTRLDVCTL,IOCTRLDVGT.IOCTRLFDGT.IOCTRLGTJIOCTRLIS 


IOCTRLOS,IOCTRLRD,IOCTRLRHL,IOCTRLRTSET,IOCTRLST 
IOCTRLWD,IOCTRLWH 
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人 
震 nclnde ぐ doslib.h> 


int MALLOCO(md,size,mcb): 

int md: / ま メモ リ 割 り 当 て の モー ド */ 

int size: /* 確 保 し た い 領 域 の サイ ズ */ 

int mcb: / ま この メモ リ を 確保 する プロ グラ ム の PDB ア ドレ スー3$10 */ 


機 能 | size で 指定 され た バイ ト 数 の メモ リ 領 域 を 確保 し 、 そ の ポイ ンタ を 返し ます 。 
md に は 、 以 下 に 示す メモ リ の 割り 当て 方 法 を 指定 し ます 。 


0: 下 位 か ら 探 し 、 割 り 当 て る 。 

1: 指 定 さ れ た サイ ズ を 満た す メ モリ プロ ッ ク の うち 最小 プロ ッ ク を 割り 
当 で る 。 

2: 上 位 の 方 か ら 探し 、 割 り 当 て る 。 


size に 0x1000000 以 上 の 値 を 指定 し た と き は 、0OxFFFFFF と し て 処理 し ます 。 
MCB に は 、 自 分 の PDB ア ドレ スー$10 の メモ リ 管 理 プ ロッ クア ドレ ス を 指定 し 
ます が 、 そ の メモ リ は 自分 が 終了 に よっ て 自動 的 に 解放 きれ る も の で は な く 
て 、MEFREE 関 数 に より 自分 で 解放 する も の で あれ ば 、 0 の 値 で も か まい ませ 
ん 。 た だ し 適当 な アド レス を 指定 する と 、 そ の アド レス の MCB を も つ プ ログ 
ラム が 終了 し た 場合 に 自動 的 に 解放 ほれ る こと に な る の で 注意 が 必要 で す 。 
メモ リ を 確保 する 場合 その メモ リ は どの プロ グラ ム が 確保 し た も の で ある 
か を 表す た め に 、 現 在 動作 中 の PDB の メモ リ 管 理 プ ロッ ク 先 頭 ア ドレ ス を 記 
録 し て いま す が 、 常 駐 プ ログ ラム や デバ イス ドラ イ バ が メモ リ を 確保 し よう 
と し た 場合 、PDB は あく まで も 現在 実行 中 の メイ ンプ ログ ラム を 指し て いま 
すか ら 、 デ バイ ス ド ラ イ バ が 確保 し た メモ リ は 、 現 在 実行 中 の プロ グラ ム が 
確保 し た こと に な っ て し まい 、 こ の プロ グラ ム が 終了 する と 同時 に 、 デ バイ 
ス ド ラ イ バ が 確保 し た メモ リ も 解放 され て し まう と いう こと が お きま す 。 
この 問題 を 解決 する た め に 、 デ バイ ス ド ラ イ バ や 常駐 プロ グラ ム で は 、 こ の 
関数 を 使っ て メモ リ を 確保 する よう に し て くだ さい 。 

この 関数 は 、Human68k ver.3.0 以 後 で す サポ ー ト され て いま す 。 Human68K の 
バー ジョ ン を チェ ッ ク し て か ら 使 用 し て くだ さい 。 


戻り 値 | メモ リ が 確保 で きた と き は 、 そ の 領域 を 指す ポイ ンタ を 返し ます 。 
確保 で き な か っ た と き は 、0Ox81000000 十 最大 バイ ト 数 を 返し ます 。 
0x82000007? は まっ た く 確 保 で き な い こと を 示し ます 。 


開 照 関数 MALLOC.MALLOC2.MFREE 
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OS_PATCH (シス テム 専用 コー ル ) レベ ル 1 


書 式 | #include く doslib.h> 


int OS_PATCH(no,job_adr): 
int no: /** 下 表 を 参照 */ 
char *job_adr: /* 下 表 を 参照 */ 


Human68k ver.3.0 で サポ ー ト され た 、 外 部 コマ ンド の FASTIO, FASTOPEN, 
FASTSEEK を Human68k に 登録 し た り 制御 し た りす る た め の 関 数 で す 。 
no の 値 に よっ て 、 以 下 の 機 能 が あり ます 。 


藻 
策 


戻り 値 no の bit job_adr 意 味 
15 一 8 7<-0 
旧 adr 0 fno| adr fno の 処理 と し て 、adr を 登録 する 。 
現 adr 0 fno| 一 1 | fno の 処理 の 再 初 期 化 。 
299 0 fno| 0 fno の 処理 を 元 に 戻す 。 
229 p1(! 三 0) fno| p2 シス テム の 制御 パラ メー タ を 与え ま 
す ぶ 


999 は 、 登 録 プ ログ ラム が RESET 処 理 な ど で 返 す D0 の 値 で す 。 
fno は 、 以 下 を 意味 し ます 。 
fno 1 FASTIO 用 パッ チ 

三 2 FASTSEEK 用 パッ チ 

三 3 FASTOPEN 用 パッ チ 


この 関数 を 利用 する た め に は シス テム 内 部 の 詳細 な 知識 が 必要 な た め シ ステ 
ム 専 用 の コー ル と し ます 。 


戻り 値 | 上 の 表 を ご 参照 くだ さい 。 
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S_ MALLOCO aa 
#include dosiib.h> 


int S_MALLOCO(md,size,mcb): 

int md / ネ メモ リ 割 り 当 て の モー ド */ 

int size: /* 確保 し た い 領 域 の サイ ズ */ 

int mcb: /* ま この メモ リ を 確保 お する プロ グラ ム の PDB ア ドレ スー$10 六 / 


機 能 | size で 指定 され た バイ ト 数 の メモ リ 領 域 を 、 メ イン の メモ リ 領 域 か 確保 し 、 
その ポイ ンタ を 返し ます 。 
md に は 、 以 下 に 示す メモ リ の 割り 当て 方 法 を 指定 し ます 。 


0: 下 位 か ら 探 し 、 割 り 当 て る 。 

1: 指 定 さ れ た サイ ズ を 満た す メ モリ プロ ッ ク の うち 最小 ブロッ ク を 割り 
当 や る 。 

2: 上 位 の 方 か ら 探し 、 割 り 当 て る 。 


size に 0x1000000 以 上 の 値 を 指定 し た と き は 、0xFFFFFF と し て 処理 し ます 。 
mcb に は 、 自 分 の PDB ア ドレ スー$10 の メ モリ 管理 プ ブロック アド レス を 指定 し 
ます が 、 そ の メモ リ は 自分 が 終了 に よっ て 自動 的 に 解放 され る も の で は な く 
て 、S_MFREE 関 数 に より 自分 で 解放 する も の で あれ ば 、 0 の 値 で も か まい ま 
せん 。 た だ し 適当 な アド レス を 指定 する と 、 そ の アド レス の MCB を も つ プ ロ 
グラ ム が 終了 し た 場合 に 自動 的 に 解放 きれ る こと に な る の で 注意 が 必要 で 
す 。 

メモ リ を 確保 する 場合 、 そ の メモ リ は どの プロ グラ ム が 確保 し た も の で ある 
か を 表す た め に 、 現 在 動作 中 の PDB の メモ リ 管 理 プ ロッ ク 先 頭 ア ドレ ス を 記 
録 し て いま す が 、 常 駐 プ ログ ラム や デバ イス ドラ イ バ が メモ リ を 確保 し よう 
と し た 場合 、PDB は あく まで も 現在 実行 中 の メイ ンプ ログ ラム を 指し て いま 
すか ら 、 デ バイ ス ド ラ イ バ が 確保 し た メモ リ は 、 現 在 実行 中 の プロ グラ ム が 
確保 レ し た こと に な っ て し まい 、 こ の プロ グラ ム が 終了 する と 同時 に 、 デ バイ 
ス ド ラ イ バ が 確保 し た メモ リ も 解放 され て し まう と いう こと が お きま す 。 
この 問題 を 解決 する た め に 、 デ バイ ス ドラ イ バ や 常駐 プロ グラ ム で は 、 こ の 
関数 を 使っ て メモ リ を 確保 する よう に し て くだ さい 。 


S MALLOC0 は 、 通 常 の アプ リケーション プロ グラ ム で 使用 し て は いけ ませ 
ん 。 

S MALLOCO0 を 使用 する プロ グラ ム は 、OS か ら 起 動 さ れ て 、 終 了 す る こと が 
で き な い プロ グラ ム で な けれ ば な り ま せん 。 

この 関数 は 、Human68k ver.3.0 以 後 で す サポ ー ト され て いま す 。 Human68K の 
バー ジョ ン を チェ ッ ク し て か ら 使 用 し て くだ さい 。 


戻り 値 | メモ リ が 確保 で きた と き は 、 確 保 で きた 領域 を 指す ポイ ンタ を 返し ます 。 


確保 で き な か っ た と き は 、0x81000000 十 最大 バイ ト 数 を 返し ます 。 
0x82000007? は 全く 確保 で き な い こと を 示し ます 。 


MALLOC.MFREE,S_MALLOC,S_MFREE,S PROCESS 
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拡張 |)OCS コ ー ル ライ ブラ リ 


ここ で は 、X68030 あ る い は IOCSX で 新規 に 追加 きれ た IOCS コ ユー ル ラ イブ ラリ を 説明 し 
で ゆま ほす 。 

IOCSX の 詳細 に つい て は 、 「 プ ログ ラマ ー ズ マニ ュ ア ル 」]| の 「 付 録 7 IOCSX| を 参 
照 し て くだ さい 。 

な お 、X68030 で は IOCS. 双 の 組み 込み を 行う 必要 は あり ませ ん 。 


@ ラ イブ ラリ ーー 覧 (アル ファ ベッ ト 順 ) 


名 前 機 能 頁 
B_CURDEF カー ソル の パタ ー ン 定義 109 
B_CURMOD カー ソル の 点滅 の 制御 109 
B_CURPAT カー ソル の 形状 (パタ ー ン ) の 制御 110 
B_CURPAT1 カー ソル の 形状 (開始 ライ ン ) の 制御 110 
B_SCRLL 画面 スク ロー ル の 設定 111 
CASHE_MD オン チッ プ キ ャ ッシュ メモ リ の 制御 111 
CASHE_ST オン チッ プ キ ャ ッシュ メモ リ 状 態 の 調査 112 
DRAWMODE グラ フィ ッ ク 画 面 の 描画 モー ド の 設定 112 
MPU_STAT MPU の 種類 、 動 作 周波 数 、 演 算 コ プロ セッ サ 有 無 、| 113 

MMU の 有無 を 返す 
TXLINE テキ スト 画面 へ の ライ ン 描 画 113 
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3. 2 拡張 OCS コー ル ラ イ ぽ ラリ 


FLB_CURDEFーーーーーーーーー て < 
nclude ぐ iocsHb.h> 


void B_CURDEF (PATBUP): 
unsigned char PATBUF: / ま パタ ー ン バッ ファ キネ / 


機 能 | カー ソル の バタ ー ン を 定義 し ます 。 
PATBUF で 指定 され て いる 最初 の 16 バ イト が プレ ー ン 0 の パタ ー ン 、 次 の 16 バ 
イト が プレ ー ン 1 の パタ ー ン と な り ま す 。 


X68030 で は この 機能 は 動作 し ませ ん 。 
また 、X68030 以 外 の 機種 で は 、IOCS.X を 常駐 させ な けれ ば な り ま せん 。 


戻り 値 | 戻り 値 は あり ませ ん 。 


人 
#include ぐ jocslib.h> 


void B_ CURMOD (MODE): 
int MODE: / 玄 カー ソル モー ドキ / 


機 能 | カー ソル の 点滅 を 制御 し ます 。 
MODE= テ 0 カー ソル を 点滅 きせ ます 。 
MODE テ 1 カー ソル を 点滅 さき せま せん 。 


X68030 以 外 の 機種 で は 、IOCSX を 常 往 させ な けれ ば な り ま せん 。 


戻り 値 | 戻り 値 は あり ませ ん 。 
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第 3 章 追加 ライ ブラ リ 


B_CURPAT 日 
nclude ぐ iocslib.h> 


void B_CURPAT (PATTERN): 
int PATTERN: / ネ カー ソル の パタ ー ン ※/ 


カー ソル の 形状 を 制御 し ます 。 
PATTERN の 指定 は 以下 の よう に し ます 。 
LLLLAAAAAAAABBBBBBBB 
LLL: カー ソル スタ ー ト ライ ン (00 一 15) 
AAAAAAAA : プレ ー ン 1 マス ク パ ター ン (Ox00 一 OxFF) 
BBBBBBBB: プレ ー ン 0 マス ク パ ター ン (Ox00 一 OxFF) 


X68030 以 外 の 機種 で は 、IOCSX を 常駐 させ な けれ ば な り ま せん 。 


戻り 値 | 戻り 値 は あり ませ ん 。 


B_CURPAT 1 二 計 
include 。 ぐ iocslid.h> 


void B_CURPAT1 ( ): 


機 能 | カー ソル の 形状 を 制御 し ます 。 ワ ー ク に あら か じ め 設 定 さ れ た カー ソル パタ ー 
ン (B_CURDEF で 設定 ) を 表示 し ます 。 


X68030 で は この 機能 は 動作 し ませ ん 。 
また 、X68030 以 外 の 機種 で は 、IOCS.X を 常 及 させ な けれ ば な り ま せん 。 


戻り 値 | 戻り 値 は あり ませ ん 。 


110 


3. 2 拡張 OCS コー ル ラ イブ ラリ 


LBP_SCHOLLーーーーーーーーー て mp 
nclude ぐ iocslib.h> 


void B_SCROLL(MODE): 
int MODE / ま スク ロー ルモード ※*/ 


機 能 
画面 スク ロー ル の 設定 を し ます 。 

MODE= テ 0 ジャ ンプ スク ロー ル 
MODE ニ 1 4 ドッ トス ムー スス クロ ー ル 
MODE ニ 2 8 ドッ トス ムー スス クロ ー ル 
MODE ニ 3 16 ド ッ ト ス ムー スス クロ ー ル 
MODE= テ 16 ラス ター コピ ー ス クロ ー ル モー ド 
MODE ニ 17 ツラ トウ ェ ア ス クロ ロー ルモード 


X68030 以 外 の 機種 ご で は 、 IOCS.X を 常駐 させ な けれ ば な り ま せん 。 


戻り 値 | 戻り 値 は あり ませ ん 。 


DO 


書 式 | jnclude < く ijocslib.h> 


void CACHE_MD(MODE): 
int MODE: /※ ま キャ ッシュ モー ドキ ※*/ 


MPU68030 の オン チッ プ キ ャ ッシュ メモ リ を 制御 し ます 。 


MODE= テ 0 命令 キャ ッシュ 無効 、 デ ー タ キャ ッシュ 無効 
MODE= テ 1 命令 キャ ッシュ 有効 、 デ ー タ キャ ッシュ 無効 
MODE2 命令 キャ ッシュ 無効 、 デー タキ ャ ッシュ 有効 
MODE=3 命令 キャ ッシュ 有効 、 デ ー タ キャ ッシュ 有効 
MODE ニ テー1 ギャ ッシュ の アジ ッシュ 

MODE ニ テー2 キャ ッシュ の 状態 を SRAM の 設定 値 に する 。 


X68030 の み に 使用 で きま す 。 


戻り 値 | 戻り 値 は あり ませ ん 。 
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第 3 章 追加 ライ ブラ リ 


CACH E_S「 レベ ル 0 
nclnde ぐ iocslib.h> 


int CACHE_ST( ): 
機 能 MPU68030 の オン チッ プ キ ャ ッシュ メモ リ 状 態 を 調べ ます 。 


X68030 の み に 使用 で きま す 。 


戻り 値 | キャ ッシュ の 状態 が 返り ます 。 


戻り 値 デー タキ ャ ッシュ 命令 キャ ッシュ 
0 無効 無効 
1 無効 有効 
2 有効 無効 
3 有効 有効 


DRAWMODE に 
| 書 式 | #include <iocslib.h> 


void DRAWMODE(MODB): 
int MODE: / 六 描画 モー ド ※*/ 


グラ フィ ッ ク 画 面 の 描画 モー ド を 設定 し ます 。 
MODE=0 通常 描画 モー ド 
MODE ニ 1 反転 描画 モー ド 


X68030 以 外 の 機種 で は 、IOCS. 双 を 常駐 さす せな けれ ば な り ま せん 。 


戻り 値 | 戻り 値 は あり ませ ん 。 
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3。 2 拡張 OCS コー 州 芝 で まま 要 リ 


MPU_STAT 生生 
#inclnde ぐ iocsiib.h> 


unsigned int MPU_STAT(): 


X68030 の 状態 を 調べ ます 。 


MPU の 種類 、 動 作 周波 数 、 演 算 コ プロ セッ サ 有 無 、MMU の 有無 を 返し ます 。 


X68030 の み に 使 用 し て くだ さい 。 


戻り 値 | 32 ビ ッ ト の 戻り 値 の 意味 は 以下 の よう に な り ま す 。 


ビッ ト 31-16 MPU の 動作 周波 数 (MHz)X 1 0 


且 1 演算 コ プ ロ セッ サ の 有無 (1 で あり ) 
ヶ 14 MMU の 有無 (1 で あり ) 
ヶ 7-0 MPU の 種類 

0 68000 

1 68010 

2 68020 

3 68030 


TXLINE レベ ル 0 


書 式 #include ぐ jiocslib.h> 


void TXLINE(TXPTR): 
struct LINEPTR *※TXPTIRP: 
struct LINEPTR [ 
unsigned short vram_page: / キ テキ スト の ペー ジ 六 / 


Short x: /* 始点 X 座 標 **/ 
Short y: / 玉 始点 Y 座 標 * ま / 
Short x: /* 終点 まで の X の 長 さ ※*/ 
Short 7: /\* 終点 まで の Y の 長 さ */ 


unsigned short line_style: / ま ライ ンス タイ ルキ ギ / 
8 


テキ スト 画面 に ライ ン を 描き ます 。 
XX68030 以 外 の 機種 で は 、IOCSX を 常駐 させ な けれ ば な り ま せん 。 


戻り 値 | 戻り 値 は あり ませ ん 。 
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OPMDRV 3 ライ ブラ リ 


「C compiler PRO-68K ver2.1 NEW KIT|] で は 、 (FM 音源 MIDIADPCM を 制御 で き 
る ) OPMDRV3.X 用 の ライ プラ リ が サポ ー ト され て いま す 。 


これ に より 、 新 し く 次 の ファ イル が ver2.1 よ り 追 加 ノ 変更 され て いま す 。 


MUSIC.H FM 音源 (MIDIADPCM 対 応 ) 用 関数 の 定義 


MUSIC3.H FM 音源 /MIDIADPCM 用 拡張 関数 の 定義 


BASLIB.L BASTOC ラ イブ ラリ 


な お 、「|C compiler PRO-68K ver2.1 NEW KIT| で サポ ー ト され て いた OPMDRV2.X 用 の 
ライ ブラ リ (「[C コ ン パ イラ ライ ブラ リマ ニュ アル 1 | を 参照 ) は 新しい OPMDRV3.X 


用 の ライ ブラ リ と は 互換 性 が あり ませ ん の で ご 注意 くだ さい 。 
従来 の OPMDRV2.X 用 の ライ ブラ リ を ご 使用 に な り た い 場 合 は 、XC ラ イプ ブラ リ デ ィ ス ク 


の MUSIC ディ レク トリ に 入っ て いる ファ イル を ご 使用 くだ さい 。 
(OPMDRV3. 双 用 の ライ ブラ リ と 同時 に 利用 する こと は で きま せん ) 
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3. 3 OPMDRV3 ラ イブ ラリ 


@ ラ イブ ラリ 一覧 (OPM コ ー ル 番号 順 ) 


番号 l 名 前 機 能 具 

$OO m_init トラ ッ ク バ ッ フ ァ の 初期 化 124 
$01 m_alloc 指定 トラ ッ ク の トラ ッ ク バ ッ フ ァ の 確保 117 
$02 m_assign 指定 チャ ン ネ ル の トラ ッ ク 設 定 118 
$03 m_vget FM 音源 の 音色 デー タ 取 得 151 
$04 m_vset FM 音源 の 音色 を 設定 153 
$05 m_tempo テン ポ 指 定 147 
$06 m_trk 指定 トラ ッ ク に MML デ ー タ を セッ ト 148 
$07 m free 指定 トラ ッ ク バ ッ フ ァ の 残り バイ ト 数 を 返す 123 
$08 m_play 指定 チャ ン ネ ル の 演奏 開始 140 
$09 m_stat 指定 チャ ン ネ ル の 演奏 状態 を 返す 144 
$0A m_stop 指定 チャ ン ネ ル の 演奏 を 一 時 停止 144 
$OB m_cont 指定 チャ ン ネ ル の 演奏 再開 120 
$OC m_atoi 指定 トラ ッ ク バ ッ フ ァ の 先頭 アド レス を 返す 118 
$OF m_use 指定 トラ ッ ク バ ッ フ ァ の 使用 容量 を 返す 149 
$10 m_chan デー タ 出 力 チ ャ ン ネ ル を 一 時 変更 119 
$11 m_DrOg 指定 チャ ン ネ ル の 音色 番号 設定 142 
$12 m_vol 指定 チャ ン ネ ル の ボリ ュー ム 設 定 151 
$13 m_pan 指定 チャ ン ネ ル の パン ポッ ト 設 定 133 
$14 m_vel 指定 チャ ン ネ ル の ベロ シテ ィ 設 定 150 
$15 m_trns 指定 チャ ン ネ ル の 音程 シフ ト 149 
$18 m_anioff 指定 チャ ン ネ ル へ の オー ルノー ト オ フ 出力 117 
$19 m_dirout MIDI 出 力 121 
$1A m_enable 指定 チャ ン ネ ル の 発音 許可 121 
$1B m_nton 指定 チャ ン ネ ル ヘ へ ノート オ ン 出 力 130 
$1C m_ntoff 指定 チャ ン ネ ル ヘ へ ノート オ フ 出 力 130 
$20 m_sync MIDI の 同期 モー ド を 設定 145 
$21 m_meter 曲 の 拍子 設定 126 
$29 m_sndset SND77 人 7 ル の デー タ を FM 音源 用 に 登録 142 
$2A m_pcmset | 指定 の 音程 に PCM 音 を 登録 139 
$2B m_sysch チャ ン ネ ル 番 号 の 割り 当て 変更 146 
$2C m_ifchk MIDI イ ンター フェ イス の 有無 チェ ッ ク 124 
$2F m_freea ド 5 起動 時 の ト ?72 パ "777 の 全 / 介 数 を 返す 123 
$30 m_out 1 バイ ト デ ー タ を MIDI へ 出力 133 
$32 m_meas 演奏 中 の 小節 番号 を 返す 126 
$33 m_ycom Y コ マン ド の 解釈 154 
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名 前 

Im_Start 

m_end 

m_modsns 
m_pcrnrec 
m_pcmget 
m_pcmlen 
m_pcmbsy 
m_pcmon 
m_citrlres 
m_ODmreg 
m_mdreg 
m_tnmset 
m_tnmget 
m_pnmset 
m_pnmget 
m_mstvol 
m_bend 

m_mod 

m_ODmexC 
m_opmlfq 
m_pgmflt 
m_volflt 

m_panflt 
m_version 
m_errget 
m_mcont 
m_mplay 
m_mstop 
m_mute 

m_pcmclr 
m_solo 


機 能 
演奏 開始 小節 の 設定 
演奏 停止 小節 の 設定 
FM 音源 の モジ ュ レ ーション の 深き 設定 
外部 入力 音 の PCM 録 音 


登録 きれ て いる PCM デ ー タ の 取得 

指定 され た PCM デ ー タ の サイ ズ を 返す 
PCM の 実行 状態 を 返す 

指定 され た PCM デ ー タ の 再生 

指定 チャ ン ネ ル へ の 各種 の オフ 出力 
指定 の OPM レ ジス タ に デー タ を セッ ト 
MIDI 制 御 IC の レジ スタ に デー タ を セッ ト 
FM 音源 の 音色 名 の 登録 

FM 音源 の 音色 名 の 取得 
PCM 音 色 名 の 登録 

PCM 音 色 名 の 取得 

マス ター ボリ ュー ム の 設定 

指定 チャ ン ネ ル の ピッ チ ベ ン ド 設 定 
指定 チャ ン ネ ル の モジ ュ レ ーション 設定 
FM 音源 の パラ メー タ セ ッ ト の 選択 

FM 音源 の LFO の 発振 周波 数 の 設定 

MML 音 色 切 り 替 え を コマ ンド の 出力 選択 
MML ボ リュ ー ム 設定 コマ ンド の 出力 選択 
MML パ ン ポ ッ ト 設 定 コ マン ド の 出力 選択 
OPMDRV3.X の バー ジョ ン と 作成 日 付 を 返す 
直前 の MUSIC 関数 の エラ ー コ ー ド を 返す 
ビッ ト パ タ ー ン 指定 チャ ン ネ ル の 演奏 再開 
ビッ ト パ タ ー ン 指定 チャ ン ネ ル の 演奏 開始 
ビッ ト パ タ ー ン 指定 チャ ン ネ ル の 演奏 一 時 停止 
指定 チャ ン ネ ル の 音 を 消音 

PCM バ ッ フ ァ の クリ ア 

指定 チャ ン ネ ル 以 外 の 音 を 消音 
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3 。 3 OPMDRVS3 ラ イプ ラリ 


m alloc に っ 
#include く music.h 


int m_alloc(LS): 
char /* トラ ッ ク 番 号 (1 一 80) */ 
int S: / ま バッ ファ サイ ズ (4 一 65535) */ 


機 能 | 指定 トラ ッ ク の トラ ッ ク バ ッ フ ァ を 確保 し ます 。 
全 ト ラッ ク バ ッ フ ァ 内 の デー タ は クリ ア さ れ ま す 。 
{に 一 1 また は "NAST を 指定 し た 場合 、 全 て の トラ ッ ク を バッ ファ サイ ズ s で 確 
保 し ます 。 
な お 、 総 トラ ッ ク の バッ ファ サイ ズ (それ ぞ れ の トラ ッ ク に 割り 当て られ て 
いる トラ ッ ク バ ッ フ ァ の 総合 計 ) は 、CONFIG.SYS フ ァイル 内 の OPMDR V3.X 
の あと に 指定 し て 、 再 度 シ ステ ム 起 動 す る こと に より 変更 で きま す 。 


DEVICE = \SYS\OPMDRV3.X #nnn 
(nnn : 総 ト ラ ッ ク バ ッ フ ァ サ イズ [単位 : KB] ) 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 


エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
き まず す 。 


Lm_anto サ ーーーーーーーーーー と xxa ] 


書 式 nclude ぐ music3.h> 


int mantoff(c): 
int 。 c:  / ネ チャ ン ネ ル 番 号 (1 一 25) */ 


指定 の チャ ン ネ ル へ オー ルノー ト オ フ を 出力 し ます 。 
c に 一 1 また は NAST を 指定 し た 場合 、 全 て の チャン ネル へ オー ルノー ト オ フ 
を 出力 し ます 。 

正常 終了 の 場合 は 0 を 返し ます 。 
エラ ー の 場合 は -1 を 返し 、 そ の エラ ー コ ー ド は mm_errget 関 数 で 調べ る こと が 
LA に: 9 3 
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1_aSSIOdT1 レー 
書 式 | #include く music.h> 


int m_aSssign(C,D: 
char Cc: /※ ま チャ ン ネ ル 番 号 (1 一 25) */ 
char /* トラ ッ ク 番 号 (1 一 80) */ 


指定 の チャ ン ネ ル c で 使用 する トラ ッ ク t を 設定 し ます 。 
t に 一 1 また は "NAST を 指定 し た 場合 チャ ン ネ ル c に 設定 され て いる トラ ッ ク 


番号 を 返し ます 。 
丁 数 の チャ ン ネ ル に 同一 の トラ ッ ク を 割り あて る と 、 そ れ ぞ れ 同 じ 楽 譜 デ ー 
タ を 演奏 し ます 。 


また 、 複 数 の トラ ッ ク を 1 つの チャ ン ネ ル に 割り あて る と 、 最 も 新しく 割り 
ふら れ た トラ ッ ク の 楽譜 デー タ を 演奏 し ます 。 

デフ ォ ル ト 値 は 、 チ ャ ン ネ ル 1-25 が 、 そ れ ぞ れ ト ラッ ク 1 一 25 に 対応 し ま 
宣 


正常 終了 の 場合 は 0 を 返し ます 。 
エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
( 飼 き ます :s 
{に 一 1 また は "NAST を 指定 し た 場合 、 チ ャ ン ネ ル c に 設定 され て いる トラ ッ ク 
番号 を 返し ます 。 


m_atOl レー 
#jinclude ぐ music.h 


int m_atoi(D: 
char /* トラ ッ ク 番 号 (1 一 80) */ 


機 能 | トラ ッ ク t の トラ ッ ク バ ッ フ ァ 先 頭 ア ドレ ス を 返し ます 。 
トラ ッ ク バ ッ フ ァ は 、OPMDRV3.X の 内 部 バッ ファ の た め 、 ス ー パ ー バ イザ 


領域 で す 。 
デー タ の アク セス に は 、 注 意 し て くだ さい 。 


戻り 値 トラ ッ ク バ ッ フ ァ の 先頭 アド レス を 返し ます 。 
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Fm_Den ロ ーーーーーーーーーーー 着 


書 式 | #inclnde く music3.h 


int m_bend(c,b): 
int (R /* ま チャ ン ネ ル 番 号 (1 一 25) ネ / 
char b: / ネ ピッ チ ベ ン ド デ ー タ (0 一 127) 玉 / 


機 能 | 指定 の チャ ン ネ ル の ピッ チ ベ ン ド を 設定 し ます 。 
c に 一 1 また は "NAST を 指定 し た 場合 、 全 て の チャ ン ネ ル に b を 設定 し ます 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 


エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま す 。 


m_chan 本 
#inclunde ぐ く music3.h 


int m_chan(cl,c2): 
char cl: /* チャ ン ネ ル 番 号 (1 一 25) */ 
int  c2: /* 出力 チャ ン ネ ル 番 号 (1 一 25) */ 


c2 に 一 1 また は TAST を 指定 し た 場合 、 現 在 の 設定 値 を 返し ます 。 
m_assign 関 数 や MML デ ー タ @N と は 異な り 、 チ ャ ン ネ ル 変 更 前 の パラ メー タ 
(トラ ッ ク 番 号 、 音 色 番号 、 ボ リュ ー ム な ど ) を 引き 継ぎ ます 。 
m_init 関 数 実行 まで 有効 で す 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 


エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m _errget 関 数 で 調べ る こと が 
で きま す 。 


指定 の チャ ン ネ ル の デー タ 出 力 チ ャ ン ネ ル を 一 時 的 に 変更 し ます 。 
や い 294 
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Il _C 0 「] { レベ ル 3 
書 式 振 nclude く music.h> 


int m_cont(cl,c2,c3,c4,cS,c6,c7,c8): 
int clLc2,c3.c4.c5.c6,c7,c8: / ネ チャ ン ネ ル 番 号 (1 一 25) */ 


機 能 | cl から c8 で 指定 さき れん た チャ ン ネ ル に お いて 、 一 時 停止 し た 演奏 を 再開 し ま 
宮 。 
指定 する チャ ン ネ ル の 個数 が 7 個 以下 の 場合 は 余り の 引数 に NAST を 指定 し な 
けれ ば な り ま せん 。 
cl 一 c8 が 全て NAST な ら ば 、1 一 25 チ ャ ン ネ ル 中 、 現 在 一 時 停止 し て いた チャ 
ン ネ ル を 全て 演奏 再開 し ます 。 


エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま す 。 


正常 終了 の 場合 は 0 を 返し ます 。 


参照 関 精 m_stop 


デー ビ 


m ctrlres 
書 式 振 nclude く music3.h> 


int  m cirlres(C): 
int Ci / ネ チャ ン ネ ル 番 号 (1 一 25) */ 


機 能 | 指定 の チャ ン ネ ル ヘ へ ピッチベンド オフ ノ モ ジ ュ レ ーション オフ ノダ ン パ ー オ 
フ ノ オ ー ル ノー ト オ フ を 出力 し ます 。 
c に 1 また は "AST を 指定 し た 場合 、 全 て の チャ ン ネ ル へ ヘ へ ピッチベンド オフ ング 
モジ ュ レ ーション オフ ノノ ダンパー オフ ププ オ ー ル ノー ト オ フ を 出力 し ます 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 
エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま ボ 。 


1 


IN 
の 】 
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m_dirout レベ 


書 式 #include く music3.h> 


int m_dirout(lng,ca): 
int lng: / デー タ サ イズ 玉 / 
char *ca:  /※ MIDI デ ー タ の 先頭 アド レス */ 


機 能 | Ing バ イト の MIDI デ ー タ を MIDI へ 出力 し ます 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 エ ラー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー 
ド は m_errget 関 数 で 調べ る こと が で きま す 。 


m_ou 


m_enable レーs 
#include ぐ music3.h ン 


int m_enable(cD): 
int cp: / ギ チャ ン ネ ル の ビッ ト パ タ ー ン ギ / 


機 能 | ビッ ト パ タ ー ン で 指定 され ん た チャ ン ネ ル の 発音 を 許可 し ます 。 
ビッ ト 0-24 が チャ ン ネ ル 1 一 25 に 対応 し て お り 、 発 音 を 許可 し た い チ ャ ン ネ 
ル に 対応 し た ビッ ト に 1 を 指定 し ます ( 他 の ビッ ト は 常に 0 で す ) 。cp に 0 を 
指定 し た 場合 、 全 て の チャ ン ネ ル の 発音 を 許可 し ます 。 
cp に 一 1 また は NAST を 指定 し た 場合 、 全 て の チャ ン ネ ル の 状態 を bi(0 一 24 に 返 
し まま 。 
m_mute 関 数 と m_solo 関 数 の ミュ ー ト 設定 は 解除 きれ ます 。 
m_mstop 関 数 と は 異な り 、 内 部 的 に は ノー ト 以 外 の デー タ の 演奏 は 継続 し て い 
ます (ミュ ー ト 状態 ) 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 エ ラー の 場合 は 一 1 を 返し 、 そ の エラ ー コ ー 
ド は m_errget 関 数 で 調べ る こと が で きま す 。 


参照 関 導 mmconum_mplay,m_mstopm_mutem_solo 
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Im_6G nd レベ ル 3 


ヨ #include く music3.h 


int mend(m): 
int mi /** 小節 番号 ネ / 


演奏 を 停止 する 小節 を 設定 し ます 。 
全て の チャ ン ネ ル の | : D.S D.C : | な どの 位置 が 同じ で な いと 正常 な 演奏 が 
で きま せん 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 
エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま す 。 


間 
二 由 


の 照 関 が | m_Start 


Fm_err99etーーーーー バ ーーー て xs ] 
書 式 | #include く music3.h> 

int  m_errgetO: 

直前 の MUSIC 各 関 数 (m で 始ま る 関数 ) の エラ ー コ ー ド を 返し ます 。 エ ラー 


コー ド に つい て は 、 | 付録 5 エラ ー メ ッ セ ー ジ 一 覧 」 を 参照 し て くだ さき 
い 。 


・ ・ 


和 


戻り 値 | 正常 終了 し て いる 場合 は 0 を 返し 、 エ ラー の 場合 は 1-ー65 の エラ ー コ ー ド を 返 
し ます 。 


に 
IO 
IN) 
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m_free レベ ル 3 
#nclude く music.h 


int mfree(D: 
char t: /* トラ ッ ク 番 号 (1 一 80) */ 


指定 の トラ ッ ク t【 の トラ ッ ク バ ッ フ ァ の 残り バイ ト 数 を 返し ます 。 
戻り 値 トラ ッ ク バ ッ フ ァ の 残り バイ ト 数 を 返し ます 。 
m_fees 


m freea レー 
#include く music3.h 


int m_freea(: 


ドラ イ バ 起 動 時 に 確保 し た トラ ッ ク バ ッ フ ァ の 全 バ イト 数 を 返し ます 。 
戻り 値 トラ ッ ク バ ッ フ ァ の 全 バ イト 数 を 返し ます 。 
m_freem_use 
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m_ifchK ーー 
##include ぐ music3.h 


int m_ifchk(): 


MIDI イ ンタ ー フ ェ イ ス の 有無 を チェ ッ ク し ます 。 


戻り 値 | イン ター フェ イス が つなが っ て いる 場合 は 0、 つ な が っ て いな い 場 合 は ー1 を 
返し ます 。 


隙 nlt レベ ル 3 
書 式 #include く music.h 


int m_init(md): 
int md: /* 初期 化 モ ー ド */ 


機 能 | トラ ッ ク バ ッ フ ァ を 初期 化し ます 。 
各 ト ラッ ク バ ッ フ ァ は 4 バイ ト に 設定 され ます 。 
また 、 各 チャ ン ネ ル の パラ メー タ (トラ ッ ク 番 号 、 音 色 番号 、 ボ リュ ー ム な 
ど ) も 初期 化 さ れ ま す 。 
md に 1 を 指定 し た 場合 、 FM 音源 の 音色 デー タ も 初期 化し ます 。 
md に 0 また は "NAST を 指定 し た 場合 は 音色 デー タ は 初期 化し ませ ん 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 


エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は mm _errget 関 数 で 調べ る こと が 
で きま す 。 
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m_mcont レー 
#include ぐ music3.h 


int m_mcont(cD): 
int cp: / ネ チャ ン ネ ル の ビッ ト パ タ ー ン 六 / 


機 能 | ビッ トバ パ ター ン で 指定 され た チャ ン ネ ル の 演奏 を 再開 し ます 。 
ビッ ト 0 一 24 が チャ ン ネ ル 1-25 に 対応 し て お り 、 演 奏 を 再開 し た い チ ャ ン ネ 
ル に 対応 し た ビッ ト に 1 を 指定 し ます ( 他 の ビッ ト は 常に 0 で す ) 。 cp に 0 ま 
た は 一 1 また は “NASI'′ を 指定 し た 場合 、 全 て の チャ ン ネ ル の 演奏 を 再開 し 
まず ま 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 
エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きき ます 。 


m_enable,m_mplay,m_mstop 


| m_mdred レベ ル 3 | 


書 式 | #include く music3.h> 


int mmdreg(gr,adr,dD: 

char gr: /* グル ー プ 番号 */ 
char adr: /* アド レス 番号 */ 
char dE  /※ 書き 込む デー タ ※/ 


機 能 | MIDI 制 御 IC (YM3802) の レジ スタ に 値 を 書き 込み ます 。 
g に は グル ー プ 番号 、adr に は アド レス 番号 、dt に は レジ スタ に 書き 込む 値 を 0 
ー255 の 範囲 で 指定 し ます 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 


エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま すす 。 
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ーー レベ ル 3 
#include ぐ music3.h 


int mmeas(): 


現在 演奏 中 の 小 偽 番号 を 返し ます 。 
| :D.S. な どの くり 返し 記号 の 場合 は くり 返し 回 数 が その まま 加算 され ます の 
で 、 実際 の 小 館 番 号 と は 異な る 場合 が あり ます 。 


戻り 値 | 現在 演奏 中 の 小節 番号 
m_end,m_start 


m_meter ーー ニー 
nclnde ぐ music3.h> 


int m_meter(n,d): 
char n: /* 分 子 (2 一 16) */ 
char dd: /* 分 母 (2.4.8.16) */ 


機 能 | 曲 の 拍子 を 設定 し ます 。 
デフ ォ ル ト 値 は 44 拍 子 に 設定 きれ て いま す 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 


エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま す 。 
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m_mod レベ ル 3 
#include く music3.h ン 


int m_mod(c,m): 
int Ci / ま チャ ン ネ ル 番 号 (1 一 25) */ 
int 。 mi /※ ま モジ ュ レ ーション デー タ (0 一 127) 六 / 


機 能 指定 の チャ ン ネ ル の モジ ュ レ ーション を 設定 し ます 。 


c に 一 1 また は “NASI′ を 指定 し た 場合 は 、 全 て の チャ ン ネ ル に m を 設定 し ま 
す 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 


エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま す 。 


mmo 


m_modsnS 本 
#include ぐ music3.h 


int m_modsns(m): 
int  m: / ま モジ ュ レ ーション の 深 さ (0 一 127) */ 


FM 音源 全体 の モジ ェ ュ レ ーション の 深 さ を 設定 し ます 。 


m に 一 1 また は “NASI′ を 指定 し た 場合 は 、 現 在 の 設定 値 を 返し ます 。 


[| 戻り 値 | 正常 終了 の 場合 は O を 返し ます 。 
エラ ー の 場合 は 一 1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
2 導 まず 
m に 一 1 また は “NASI'′ を 指定 し た 場合 は 、 現 在 の 設定 値 を 返し ます 。 


m_mod 
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| m_mplay レベ ル 3 | 


書 式 #include く music3.h 


int m_mplay(CD): 
int cp: / ま チャ ン ネ ル の ビッ ト パ タ ー ン キキ / 


機 能 | ビッ トバ ター ン で 指定 され た チャ ン ネ ル の 演奏 を 開始 し ます 。 
ビッ ト 0-24 が チャ ン ネ ル 1 一 25 に 対応 し て お り 、 演 奏 を 開始 し た い チ ャ ン ネ 
ル に 対応 し た ビッ ト に 1 を 指定 し ます ( 他 の ビッ ト は 常に 0 で す ) 。cp に 0 ま 
た は 一 1 “NASI′ を 指定 し た 場合 、 全 て の チャ ン ネ ル の 演奏 を 開始 し ます 。 


例 ) チャ ン ネ ル 1 一 13 と チャ ン ネ ル 22-25 の 演奏 を 開始 し ます 。 
m_mplay(Ox1EO1FFF) 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 
エラ ー の 場合 は 一 1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま す 。 


参照 関 毅 m enablem_mcontum_mstop 


m_mStop レベ ル 3 


#inclunde く music3.h 


中 
貞 


int mmstop(cD): 
int CcDi / 率 チャ ン ネ ル の ビッ ト パ タ ー ン 玉 / 


ビッ ト パ タ ー ン で 指定 され た チャ ン ネ ル の 演奏 を 一 時 停止 し ます 。 

ビッ ト 0-24 が チャ ン ネ ル 1-25 に 対応 し て お り 、 演 奏 を 一 時 停止 し た い チ ャ 
ン ネ ル に 対応 し た ビッ ト に 1 を 指定 し ます ( 他 の ビッ ト は 常に 0 で す ) 。 cp に 
0 また は 1 また は "NASI′ を 指定 し た 場合 、 全 て の チャ ン ネ ル の 演奏 を 一 時 
停止 し ます 。 


= 
リコ 
で で 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 
エラ ー の 場合 は 1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
Le dE 


参照 関 導 menablem_mcontm_mplay 


IN) 


1 


3. 3 OPMDRV3 ラ イブ ラリ 


m_mstvol 75: 


書 式 #include く music3.h> 


int m_mstvol(①): 
int 。 Vi: / ま ボリ ュー ム デ ー タ (0 一 127) * ネ / 


機 能 | マス ター ボリ ュー ム を 設定 し ます 。 
デフ ォ ル ト 値 は 127 に 設定 され て いま す 。 
v に 一 1 また は “NASI' を 指定 し た 場合 、 現 在 の 設定 値 を 返し ます 。 
m_init 関 数 を 実行 する まで 有効 で す 。 
PCM の チャ ン ネ ル に 対し て は 無効 で す 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 

エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m _errget 関 数 で 調べ る こと が 
で きま す 。 

v に 一 1 また は “NASI′ を 指定 し た 場合 、 現 在 の 設定 値 を 返し ます 。 


m_initm_vol 


疹 照 関 太 


3 
時 
ー 
で 


| ーー レベ ル 3 | 


書 式 震 include く music3.h> 


int m_mute(c1,c2,c3,c4,cS,c6,c7,C8): 
int clLc2,c3,c4.cS,c6,c7,c8:  / ま チャ ン ネ ル 番 号 (1 一 25) */ 


: ・ 
q* 
CC 


c1 か ら c8 で 指定 し た チャ ン ネ ル の 音 を ミュ ー ト (消音 ) し ます 。 

ノー ト 以 外 の デー タ は 常に 出力 され ます 。 

c1 か ら c8 が 全て "NASI'" な ら ば 全て の チャ ン ネ ル の ミュ ー ト が 解除 され ます 。 
8 個 以 上 の チャ ン ネ ル を 同時 に ミュ ー ト する 場合 は 、m_enablc 関 数 を 使用 し て 
くだ さい 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 
エラ ー の 場合 は 一 1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま す 。 


[会 照 関 義 m enablem_solo 
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m_ntoff レ 生 
#include ぐ く music3.h 


int m_ntoff(c,nt,vel): 


ChAF  @5 /※ ま チャ ン ネ ル 番 号 (1 一 25) * ネ / 
char nt /* ノー ト 番 号 (0 一 127) */ 
int ve / ネ ベロ シテ ィ イィ (0 一 127) * ネ / 


機 能 | 指定 の チャ ン ネ ル ヘ ノー ト オ フ を 出力 し ます 。 
vel に 一 1 また は "NASI′ を 指定 し た 場合 、 ベ ロ シ テ ィ 値 を 64 で 出力 し ます 。 


エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま す 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 


m_nton レベ ル 3 


書 式 | jnclude く music3.h> 


int m_nton(c,nt,vel): 


char ci: / ネ チャ ン ネ ル 番 号 (1 一 25) */ 
char nt /* ノー ト 番 号 (0 一 127) */ 
int vel: /※ ま ベロ シテ イィ (0 一 127) */ 


機 能 | 指定 の チャ ン ネ ル ヘ ノー ト オ ン を 出力 し ます 。 
vel に 一 1 また は “NASI'′ を 指定 し た 場合 、 ベ ロ シ テ ィ 値 を 64 で 出力 し ます 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 


エラ ー の 場合 は 1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま す 。 


1 


OO 


0 


3. 3 OPMDRV3 ラ イブ ラリ 


「T1_ODITIGXC レベ ル 3 
nclude ぐ music3.h 


int m_opmexc(md): 
int md: / ま パラ メー タ な どの 設定 スイ ッ チ 六 / 


機 能 | FM 音源 に セッ ト す る パラ メー タ の 内 、LFQ プ PMD/AMD な どの 全体 に 影響 
する パラ メー タ を 音色 切り 替え 時 に セッ ト す る か どう か を 選択 し ます 。 
0 を 指定 する と セッ ト し ませ ん 。 
1 を 指定 する と セッ ト し ます 。 デ フォ ルト 値 は 1 で す 。 
md に 一 1 また は "NASI′ を 指定 し た 場合 、 現 在 の 状態 を 返し ます 。 


正常 終了 の 場合 は 0 を 返し ます 。 


戻り 値 | エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま す 。 
md に 一 1 また は "NASI′ を 指定 し た 場合 、 現 在 の 状態 を 返し ます 。 


m_ VSet 


参照 関 数 


Fm_opmlfdーーーーーーーーーーー て xs 」 
指 nclnde く music3.h> 


int m_opmlfq(spd): 
int spd: /* ま スピ ー ド ※*/ 


機 能 | FM 音源 の LFO の 発振 周波 数 (スピ ー ド ) を 設定 し ます 。 
0-255$ を 指定 し ます 。 デ フォ ルト 値 は 198 で す 。 
spd に 一 1 また は "NASI' を 指定 し た 場合 、 現 在 の デー タ を 返し ます 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 


エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
まま まま 。 
spd に 一 1 また は “NASI′ を 指定 し た 場合 、 現 在 の デー タ を 返し ます 。 
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1_ODIT1TGd し 
久 nclude ぐ music3.h 


int mopmmreg(reg,dai3): 
int reg: / ま OPM レ ジス タ 番 号 (0 一 25$) */ 
int data: /* ま OPM へ 書き 込む デー タ (0 一 255) */ 


機 能 | 指定 の OPM レ ジス タ に デー タ を セッ ト し ます 。 
data に 一 1 ま た は "NAST を 指定 し た 場合 は 、 現 在 の デー タ を 返し ます 。 
一 度 も 指定 の OPM レ ジス タ が 書き 換え られ て いな い 場 合 は 、 一 1 を 返し ま 
も 。 
reg,data 両 方 に 一 1 また は NAST を 指定 し た 場合 は 、OPM レ ジス タバ ッ フ ァ の ポ 
イツ グ み を 返し ます 。 
OPM レ ジス タバ ッ フ ァ は 、 各 レジ スタ に つき 2 バイ ト ず つ 計 5 1 2 バイ ト あ 
り 、 現 在 ま で に レジ スタ が 書き 換え られ な か っ た 場合 は 、 そ の レジ スタ 位置 
に 一 1 (ワー ド ) が セッ ト さ れ て いま す 。 
OPM レ ジス タバ ッ フ ァ は 、OPMDRV3X の 内 部 バッ ファ の た め 、 ス ー パ ー バ 
イザ ー 領 域 で す 。 
デー タ の アク セス に は 、 注 意 し て くだ さい 。 


正常 終了 の 場合 は 0 を 返し ます 。 
エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま す 。 
data に 一 1 ま た は "NAST を 指定 し た 場合 は 、 現 在 の デー タ を 返し ます 。 
reg,data 両 方 に 一 1 また は TAST を 指定 し た 場合 は 、OPM レ ジス タバ ッ フ ァ の ポ 
イン タ を 返し ます 。 
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ーーー 昌 レベ ル 3 
振 nclude くべ music3.h 


int  m out(data): 
char data: /* MIDI デ ー タ 玉 / 


1 バイ ト デ ー タ を MIDI へ 出力 し ます 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 エ ラー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー 
ド は m_errget 関 数 で 調べ る こと が で きま す 。 


m_dirou 


級 ーー P au レベ ル 3 
#inclnde ぐ music3.h 


int 。m_pan(c,Dan): 
int Ci /* チャ ン ネ ル 番 号 (1 一 25) */ 
int Dan: /* パン ポッ ト デ ー タ (0 一 127) */ 


機 能 | 指定 の チャ ン ネ ル の パン ポッ ト を 設定 し ます 。 
が が ボド デー クタ 


0 : ライ ト (右端 ) 
4 : センター (中央) 


127 : レフ ト (左端 ) 
c に 一 1 また は "NAST を 指定 し た 場合 は 、 全 て の チャ ン ネ ル に pan を 設定 し ま 
ずっ 
pan に 1 また は "NAST を 指定 し た 場合 は 、 現 在 の 設定 値 を 返し ます 。 


戻り 値 正常 終了 の 場合 は 0 を 返し ます 。 エ ラー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー 


ド は m_errget 関 数 で 調べ る こと が で きま す 。 
pan に 一 1 ま た は NAST を 指定 し た 場合 は 、 現 在 の 設定 値 を 返し ます 。 
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m_panflt レベ ル 3 
お nclude く music3.h ン 


int mpanflt(cmd): 
int /* チャ ン ネ ル 番 号 (1 一 25) */ 
int mdi / ま フィ イル タモ ー ド */ 


機 能 | MML デ ー タ 内 の PAN の 切り 替え を コマ ンド を 、 指 定 チ ャ ン ネ ル の 演奏 時 に 出力 
する か どう か を 選択 し ます 。 
md に 0 を 指定 し た 場合 、 フ ィ ル タ を オフ し ます 。 
md に 1 を 指定 し た 場合 、 フ ィ ル タ を オン し ます 。 
c に 一 1 また は "NAST を 指定 し た 場合 は 、 全 て の チャ ン ネ ル に md を 設定 し ま 
す 。 md に 一 1 また は "NAST を 指定 し た 場合 は 、 現 在 の 設定 値 を 返し ます 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 


エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
を の 
md に 一 1 また は "NAST を 指定 し た 場合 は 、 現 在 の 設定 値 を 返し ます 。 


m_pgmfltm_volflt 


m_PpcmDSy レベ ル 3 
希 include く music3.h 


int mpcmbsyO: 
PCM の 実行 状態 を 調べ ます 。 
戻り 値 | PCM の 実行 状態 を 以下 に 示す 値 で 返し ます 。 


Ox00 : 何 も 実行 し て いな い 

Ox02 : 出力 中 (ADPCMOUT.m_pcmon,a_play を 実行 中 ) 
Ox04 : 入力 中 (ADPCMINP,m_pcmrec,a_rec を 実行 中 ) 
Ox12 : 出力 中 (ADPCMAOT を 実行 中 ) 

Ox14 : 入力 中 (ADPCMAIN を 実行 中 ) 

Ox22 : 出力 中 (ADPCMLOT を 実行 中 ) 

Ox24 : 入力 中 (ADPCMLIN を 実行 中 ) 
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m_pcmclr に 
##include ぐ music3.h 


int m_pcmclr(): 
機 能 | PCM バ ッ フ ァ を クリ ア し ます 。 
戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 


エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま す 。 


m_Dpcm9get ーー 
include く music3.h 


int 。m_pcmget(ntca,S): 


char nt /* ノー ト 番 号 (0 一 127) */ 
char 玉 ca: /* PCM デ ー タ バッ ファ の 先頭 アド レス */ 
int si / キ バッ ファ サイ ズ */ 


登録 きれ て いる PCM デ ー タ を ca に バッ ファ サイ ズ 分 読み 込み ます 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 


エラ ー の 場合 は ー-1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま ます 。 


m_pcmlenm_Dcmset 
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m_pcmlen レベ ル 3 
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#include ぐ music3.h> 


int mm_pcmlen(n0D: 
int nb /* ノー ト 番 号 (0 一 127) */ 


指定 され た PCM デ ー タ の サイ ズ を 返し ます 。 
nt に 一 1 また は "NASI' を 指定 し た 場合 は 、PCM バ ッ フ ァ の 残り 容量 を 返し ま 
す 。 


正常 終了 の 場合 は 0 を 返し ます 。 

エラ ー の 場合 は -1 を 返し 、 そ の エラ ー コ ー ド は m_errgel 関 数 で 調べ る こと が 
で SI まず ら 

nt に 一 1 また は "NAST を 指定 し た 場合 は 、PCM バ ッ フ ァ の 残り 容量 を 返し ま 
すず 。 


m_pcmsetLm_pcmget 


3. 3 OPMDRV3 ラ イブ ラリ 


「T1_DCTT1OTI レベ ル 3 
#include くべ music3.h 


int mpcmon(nt,sfmd): 


char nc / ネ ノー ト 番 号 (0 一 127) */ 
int sf / ま サン プリ ング 周波 数 (0 一 4) */ 
int mdi /* 音声 出力 モー ド (1~3) */ 


機 能 | 指定 され た PCM デ ー タ を 再生 し ます 。 
sf と md 両方 に 1 また は AST を 指定 し た 場合 は 、 サ ンプ リン グ 周 波数 4 音声 
出力 モー ド =3 で 再生 皇統 。 


サン プリ ング 周波 数 


(U OOOOOOEEEE 3.9KHz 
1 に 5.2KHz 
2 7.8KHz 
3 10.4KHz 
し OOEUUUOIEEE 15.6KHz 


音声 出力 モー ド (オー ディ オ 出 力 端子 ) 


OOCOPOECEEEE 左 
2 右 
CCCCPZTTSE ステ レオ ( 諾 右 両 方 ) 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 
エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま す 。 


rm_Dcmmrecm_Dcmeet 
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ITm_DCITTeC レベ ル 3 
震 nclude く music3.h> 


int mpcmrec(sf,Ing,ca): 


char sf /* サン プリ ング 周波 数 (0 一 4) */ 
int lngi / デー タ サ イズ (最大 三 32767) */ 
char ca /* PCM デ ー タ バッ ファ の 先頭 アド レス */ 


機 能 | 外部 入力 音 (オー ディ オ 入 力 端子 ) を PCM 録 音 し ます 。 
実行 直後 に 入力 待ち に な り 、 約 4 秒 以 内 に 入力 が な けれ ば 実行 を 中 止 し ま 


す 。 

サン プリ ング 周波 数 
0 に mm 3.9KHz (一 秒間 に 1950 が 1 ト ) 
1 5.2KHz (一 秒間 に 2600/ 1[) 
2 に 7.8KHz (一 秒間 に 3900 が 人) 
3 10.4KHz (一 秒間 に 5200 パ 1[) 
4 15.6KHz (一 秒間 に 7800/ 1) 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 


エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま す 。 


m_pcmonm_Pcmel 
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四 結 MGS レベ ル 3 
#include ぐ music3.h> 


int mpcmset(nt.sf,Ing,ca): 


char nc / ま ノー ト 番 号 (0 一 127) */ 

char sf: / ま サン プリ ング 周波 数 (0 一 4) */ 
int lng: / ま デー タ サ イズ (最大 =32767) */ 
char ca: /* PCM デ ー タ の 先頭 アド レス 米 / 


機 能 | 指定 の 音程 に PCM 音 を 登録 し ます 。 
指定 で きる 音程 は C 一 1(0) か ら 'G8'(127) ま で で す 。 


サン プリ ング 周波 数 


(UEUOODDHHEEE 3.9KHz (一 秒間 に 1950 イト) 
OOOHHOEEOEEE $.2KHz (一 秒間 に 2600 休 ) 
2 7.8KHz (一 秒間 に 3900/ 條 ) 
KOOOUHODEE 10.4KHz (一 秒間 に 5200/ 人 ト ) 
4 に 15.6KHz (一 秒 問 に 7800 介 ) 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 


エラ ー の 場合 は 一 1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま す 。 


m_pcmgetm_pcmlen,m_pcmon,m_Dcmrec 
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| m_pgmfllt レベ ル 3 | 
#include く music3.h> 


int mpgmflt(cmd): 
int Gi /* チャ ン ネ ル 番 号 (1 一 25) キ */ 
int mdi / ネ フィ ル タ モ ー ド */ 


機 能 | MML デ ー タ 内 の 音色 の 切り 替え コマ ンド を 、 指 定 チ ャ ン ネ ル の 演奏 時 に 出力 
する か どう か を 選択 し ます 。 
md に 0 を 指定 し た 場合 フィ ル タ を オフ し ます 。 
md に 1 を 指定 し た 場合 、 フィルタ を オン し ます 。 
c に 一 1 また は "NAST を 指定 し た 場合 は 、 全 て の チャ ン ネ ル に md を 設定 し ま 
す 。 md に 一 1 また は "NAST を 指定 し た 場合 は 、 現 在 の 設定 値 を 返し ます 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 


エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま す 。 
md に 一 1 また は "NAST を 指定 し た 場合 は 、 現 在 の 設定 値 を 返し ます 。 


m_panflum_volflt 


m_play に 
#inclnde ぐ music.h 


int mplay(cl,c2,c3,c4,cS,c6,c7,c8): 
int cl.c2,c3,c4.c5,c6,c7,C8: / ネ チャ ン ネ ル 番 号 (1 一 25) */ 


機 能 | FM 音源 の 指定 し た チャ ン ネ ル に 割り あて た トラ ッ ク デ ー タ を 演奏 開始 し ま 
の 
指定 する チャ ン ネ ル の 個数 が 7 個 以下 の 場合 は 、 余 り の 引数 に "NAST を 指定 
し な けれ ば な り ま せん 。 
c1 一 c8 が 全て "NASI な ら ば 1 一 25 チ ャ ン ネ ル を 全て 演奏 開始 し ます 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 
エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errgel 関 数 で 調べ る こと が 
で きま すら 
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出 省 UMCK レベ ル 3 
#include く music3.h 


char ま m _pnmget(nt): 
char nc / 玉 ノー ト 番 号 (0 一 127) */ 


機 能 | PCM の ノー ト 番 号 に 登録 きれ て いる 音色 名 を 取得 し ます 。 


m_pnmget 関 数 と m_tnmget 関 数 は 、 ど ちら で も 続け て 使用 する 場合 、 必 ず 戻 り 
値 の ポイ ンタ が 示す 文字 列 を コピ ー し て か ら 使 用 し て くだ さい 。 


戻り 値 PCM の 音色 名 を 示す 文字 列 の ポイ ンタ を 返し ます 。 
m_pnmset 


m_pnmSset レベ ル 3 
#include ぐ music3.h> 


int  m_pnmset(ntLDn): 
char nt /* ノー ト 番 号 (0 一 127) */ 
char *pn /* PCM の 音色 名 の 先頭 の アド レス */ 


PCM の ノー ト 番 号 に 音色 名 を 登録 し ます 。( 半 角 10 文 字 以 内 ) 
戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 


エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま す 。 


m_pnrmgct 
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TI_D「O9 レベ ル 3 


書 式 #inclunde く music3.h> 


int m_pDrOg(C,D): 
int ci /* チャ ン ネ ル 番 号 (1 一 23) */ 
int Pi /** 音色 番号 (FM 音源 :1 一 200、MIDI:1 一 128) */ 


機 能 | 指定 の チャ ン ネ ル の 音色 番号 を 設定 し ます 。 
c に 一 1 また は AST を 指定 し た 場合 は 、、 全 て の チャ ン ネ ル に p を 設定 し ます 。 
p に 一 1 また は "NAST を 指定 し た 場合 は 、 現 在 の 設定 値 を 返し ます 。 
デー タ サ イズ は 、 1 音色 80 バ イト で 最大 200 音 色 分 ( 三 16000 バ イト ) まで 指 
定 で きま すず す 。 


正常 終了 の 場合 は 0 を 返し ます 。 
エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま す 。 
p に 1 また は "NAST を 指定 し た 場合 は 、 現 在 の 設定 値 を 返し ます 。 


m_sndset ーー 
書 式 nclude ぐ music3.h 


int m_sndset(ca,S): 
char *ca: /* SND フ ァイル 形式 の デー タ */ 
int si /* ま デー タ サ イズ (最大 16000) キ / 


機 能 | SOUND SX-68K、SOUND PRO-68K の SND フ ァイル 形式 の デー タ を FM 音源 用 
の 音色 デー タ と し て 登録 し ます 。 
同時 に 音色 名 も 登録 し ます 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 


エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
や でき ます 。 
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m_SOIO レベ ル 3 


書 式 #include く music3.h> 


U 


int msolo(c): 
int Ci / ま チャ ン ネ ル 番 号 (1 一 25) * ネ / 


上 指定 され た チャ ン ネ ル 以 外 の 全て の 音 を ミュ ー ト (消音 ) し ます 。 
ノー ト 以 外 の デー タ は 、 常 に 出力 され ます 。 
c に 0 また は 一 1 “NASI′ を 指定 し た 場合 、 解 除 さ れ ま す 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 
エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま す 。 
c に 0 また は 一 1 “NASI′ を 指定 し た 場合 、 解 除 さ れ ま す 。 


m_enable,m_mute 


ー 
っ ご 


m Start レベ ル 3 


書 式 震 nclnde く music3.h> 


int m_start(m): 
int m:  /* 演 奏 を 開始 する 小節 番号 *※/ 


機 能 | 演奏 を 開始 する 小節 を 設定 し ます 。 (演奏 が 終わ る と クリ ア さ れる ) 全て の 
チャ ン ネ ル の | : D.S. DC.: | な どの 数 や 位置 が 同じ で な いと 正常 な 演奏 が で 
きま せん 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 
エラ ー の 場合 は 1 を 返し 、 そ の エラ ー コ ー ド は m _errget 関 数 で 調べ る こと が 
き ます 。 


参照 関 精 mendm_meas.m_play 
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m stat レベ ル 3 


書 式 #include ぐ music.h 


1nt m_ stat(C): 
int ci / ネ チャ ン ネ ル 番 号 (1 一 25) ネ / 


指定 の チャ ン ネ ル の 演奏 状態 を 調べ ます 。 
c に 一 1 また は AST を 指定 し た 場合 は 、 全 て の チャ ン ネ ル の 状態 を bit0 一 24 に 
返し ます 。 
bit0 一 24 が チャ ン ネ ル 1 一 25 に 対応 し て いま す 。 


戻り 値 | 演奏 中 な ら 1 を 、 演 奏 終了 な ら 0 を 返し ます 。 


c に 一 1 また は AST を 指定 し た 場合 は 、 全 て の チャ ン ネ ル の 状態 を bit0 一 24 に 
返し ます 。 


m_StOD 5 
#nclude ぐ music.h 


int mstop(cl,.c2,c3,c4,cS,c6,c7,C8): 
int clLc2,c3.c4,cS,c6,c7,c8: / ネ チャ ン ネ ル 番 号 (0 一 25) */ 


機 能 | 指定 の チャ ン ネ ル の 演奏 を 一 時 停止 し ます 。 
指定 する チャ ン ネ ル の 個数 が 7 個 以 下 の 場合 は 、 余 り の 引数 に TNAST' を 指定 し 
な けれ ば な り ま せん 。 
cl 一 c8 が 全て NASIT な ら ば 、1-25 チ ャ ン ネ ル 中 、 現 在 演奏 し て いた チャ ン ネ 
ル す べ て を 一 時 停止 し ます 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 


エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で き ます 。 
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上 = MA レベ ル 3 
#nclude ぐ music3.h 


int m_sync(C): 
int  c: /* 同 期 モ ー ド */ 


MIDI の 同期 モー ド を 設定 し ます 。 


同期 モー ド 
Otto 内 部 の MIDI ク ロッ ク に 合わ せ て 演奏 
1 em 外部 の MIDI ク ロッ ク に 合わ せ て 演奏 
DOCCPOEE 外部 の FSK ク ロッ ク に 合わ せ て 演奏 


外部 同期 に する 場合 は 、m_sync(1) 実行 後 m_play 関 数 で 待機 状態 に な り MIDI 
の スタ ー ト コマ ンド ($FA) を 待ち ます 。 
c に 一 1 また は TAST を 指定 し た 場合 は 、 現 在 の 状態 を 返し ます 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 
エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま す 。 


c に 一 1 また は "AST を 指定 し た 場合 は 、 現 在 の 状態 を 返し ます 。 
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| m_sySch レベ ル 3 | 
#include く music3.h> 


int msysch(cm): 
char cm: /* 割り 当て モー ド を 示す 文字 列 の 先頭 アド レス */ 


各 音源 に 対す る チャ ン ネ ル 番 号 の 割り 当て を 変更 し ます 。 
(ドラ イ バ 組 み 込 み 時 の オプ ショ ンス イッ チ と 同じ ) 
cm に 一 1 また は "NAST を 指定 し た 場合 は 、 現 在 の モー ド を 数 値 で 返し ます 。 


割り 当て モー ド 
0="OPM"… OPMーch1 一 8 PCM 三 ch9 MIDI 三 ch10 一 25 
1="OMP"' OPM 三 ch1 一 8 MIDI 王 ch9 一 24 PCM 三 ch25 
2="MOP" (me MIDI 三 ch1 一 16 OPM 三 ch17 一 24 PCM 三 ch25 
="MPO"" MIDI 三 ch1 一 16 PCM 三 ch17 OPMーch18 一 25 
4="POM" PCM 王 ch1 OPM 三 ch2-9 MIDIーch10 一 25 
5$="PMO"'( PCMーch1 MIDI ニ ch2 一 17  OPM 三 ch18 一 25 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 


エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま が ザ ず 。 
cm に 一 1 また は "NAST を 指定 し た 場合 は 、 現 在 の モー ド を 数 値 で 返し ます 。 
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m_temDpOo レベ ル 3 
#include く music.h ン 


int  m_tempo(te): 
int te: / 率 テン ポ 玉 / 


機 能 | FM 音源 お よび MIDI の 演奏 時 の テン ポ を 指定 し ます 。 
テン ポ ボ re を 1 分 間 に 4 分 音符 を 何 回 打つ か で 指定 し ます 。 
テン ボ は 、20 一 300 の 範囲 で す 。 (デフ ォ ル ト 値 は 120) 
tc に 一 1 また は "NAST を 指定 し た 場合 は 、 現 在 の テン ポ を 返し ます 。 


正常 終了 の 場合 は 0 を 返し ます 。 
エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は mm _errget 関 数 で 調べ る こと が 
で さき: まあ 
te に 一 1 また は "NAST を 指定 し た 場合 は 、 現 在 の テン ポ を 返し ます 。 


m_tnmget レベ ル 3 
#include ぐ music3.h 


char 玉 m tnmget(vo): 
int vo: /* 音 色 番 号 (1 一 200) */ 


機 能 | FM 音源 の 音色 番号 で 示さ れる 音色 デー タ に 登録 きれ て いる 音色 名 を 取得 しま 


m_pnmget 関 数 と m_tmmget 関 数 は 、 ど ちら で も 続け て 使用 する 場合 、 必 ず 戻 り 
値 の ポイ ンタ が 示す 文字 列 を コピ ー し て か ら 使用 し て くだ さい 。 


戻り 値 | 音色 名 を 示す 文字 列 の ポイ ンタ を 返し ます 。 
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m_tnmset ーーー 


書 式 お include ぐ music3.h 


int m_tnmset(vo,tn): 
char vo /* 音色 番号 (1 一 200) ネ / 
char 素 tn: /* 音色 名 を 示す 文字 列 の 先頭 アド レス */ 


FM 音源 の 音色 番号 で 示さ れる 音色 デー タ に 音色 名 を 登録 し ます 。 
(半角 10 文 字 以 内 ) 


藻 
二 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 
エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま す 。 


書 式 指 nclude く music.h> 


int m_trk(tsD: 
char /* トラ ッ ク 番 号 (1 一 80) */ 
char 玉 st: /* MML デ ー タ */ 


機 能 | MML に よる 楽譜 デー タ を トラ ッ ク t に 書き 込み ます 。 
厳密 に いう と トラ ッ ク t に 楽譜 デー タ を 追加 し て いき ます 。 
MML デ ー タ の 終端 は 、 ヌ ル 文 字 (0) で す 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 
エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま す 。 


ーー 
選 
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m_trns 時 
#include ぐ music3.h 


int m_trns(C,StD): 
int Ci / ネ チャ ン ネ ル 番 号 (1 一 25) */ 
int st: /** 音程 を 移調 する デー タ (0 一 48) */ 


機 能 | 指定 の チャ ン ネ ル の 音程 を シフ ト し ます 。 (半音 ステ ッ プ : 土 2ocD 
デフ ォ ル ト 値 は 24 で す 。 
c に 一 1 また は "NAST' を 指定 し た 場合 は 、 全 て の チャ ン ネ ル に stp を 設定 し ま 
す 。 
stp に 一 1 また は "NAST を 指定 し た 場合 は 、 現 在 の 設定 値 を 返し ます 。 


正常 終了 の 場合 は 0 を 返し ます 。 

エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で ぐま ます 。 

stp に 一 1 また は "NAST を 指定 し た 場合 は 、 現 在 の 設定 値 を 返し ます 。 


山 と =ーー U ら ビ レベ ル 3 
#include ぐ music3.h 


int m_uSe(D: 
int EE /* トラ ッ ク 番 号 (1 一 80) */ 


機 能 | 指定 の トラ ッ ク バ ッ フ ァ の 使用 容量 を 返し ます 。 
{に 一 1 また は NAST' を 指定 し た 場合 は 、 全 て の トラ ッ ク バ ッ フ ァ の 合計 使用 容 
量 を 返し ます 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 


エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま す 。 

t に 一 1 また は NAST を 指定 し た 場合 は 、 全 て の トラ ッ ク バ ッ フ ァ の 合計 使用 容 
量 を 返し ます 。 
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m_vel レベ ル 3 
震 nclunde く music3.h ン 


int m_vel(c,veD): 
IE 5 /* チャ ン ネ ル 番 号 (1 一 25) ネ / 
int ve /* ま ベロ シテ イィ デー タ (0 一 127) */ 


機 能 | 指定 の チャ ン ネ ル の ベロ シテ ィ を 設定 し ます 。 
c に 一 1 ま た は "NAST を 指定 し た 場合 は 、 全 て の チャ ン ネ ル に vel を 設定 し ま 


す 。 

vel に 一 1 また は "NAST を 指定 し た 場合 は 、 現 在 の 設定 値 を 返し ます 。 

正常 終了 の 場合 は 0 を 返し ます 。 

エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
人 る あき ます 。 


vel に 一 1 また は "NAST を 指定 し た 場合 は 、 現 在 の 設定 値 を 返し ます 。 


m_version 還 
#include く music3.h 


int m_version (): 


機 能 | OPMDRV3.X の バー ジョ ン と 作成 日 付 を 返し ます 。 
31 


1 1 
バー ジョ ン (BCD) 作成 年 月 日 (BCD) 


例 ) 0x10920303 
バー ジョ ン 1.0 1992 年 3 月 3 日 作成 


戻り 値 | バー ジョ ン と 作成 日 付 を 返し ます 。 
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m_ VOget レベ ル 3 


書 式 include ぐ music.h 


Int mvget(VO,Ca): 
char vo: /* 音色 番号 (1 一 200) */ 
char ca: /* 音 色 デ ー タ を 格納 する パ 7?77 の 先頭 7 ド 以 (55 バイ ト ) */ 


FM 音源 の 音色 デー タ を 取得 し ます 。 
音色 デー タ を ca に 読み 込み ます 。 


葵 
坪 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 
エラ ー の 場合 は 1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま す 。 


参照 関 炒 mvset 


LTT_VOーーーーーーーーーーーーー ya 


#include く music3.h > 
int m_vol(c,vol): 
int / ま チャ ン ネ ル 番 号 (1 一 25) ネ / 
int vol / 訂 ボリ ュー ム デ ー タ (0 一 127) */ 


指定 の チャ ン ネ ル c に ボリ ュー ム vol を 設定 し ます 。 

c に 一 1 ま た は "NAST を 指定 し た 場合 は 、 全 て の チャ ン ネ ル に vol を 設定 し ま 
9 

vol に 1 また は NAST を 指定 し た 場合 は 、 現 在 の 設定 値 を 返し ます 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 
エラ ー の 場合 は 一 1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま す 。 
vol に 一 1 ま た は "NAST を 指定 し た 場合 は 、 現 在 の 設定 値 を 返し ます 。 


・ 


誠 照 関 義 m mstva 
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m_volfl し 
inclnde ぐ music3.h ン 


1int m_volflt(cmd): 
int Ci /* ま チャ ン ネ ル 番 号 (1 一 25) */ 
int md: / 玉 フィル タモ ー ド */ 


機 能 | MML デ ー タ 内 の ボリ ュー ム 設 定 コ マン ド を 、 指 定 チ ャ ン ネ ル の 演奏 時 に 出力 
する か どう か を 選択 し ます 。 
md に 0 を 指定 し た 場合 、 フ ィ ル タ を オフ し ます 。 
md に 1 を 指定 し た 場合 、 フ ィ ル タ を オン し ます 。 
c に 一 1 ま た は "NASIT' を 指定 し た 場合 は 、 全 て の チャ ン ネ ル に md を 設定 し ま 
す 。md に 一 1 ま た は "NAST を 指定 し た 場合 は 、 現 在 の 設定 値 を 返し ます 。 


戻り 値 | 正常 終了 の 場合 は 0 を 返し ます 。 


エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で を ます 。 
md に 一 1 また は "NAST を 指定 し た 場合 は 、 現 在 の 設定 値 を 返し ます 。 


mLpanfim_pgmih 
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3。 3 OPMDRVWG ラ イ ウ ラリ 


m_ VSet レベ ル 3 


#include ぐ music.h> 


int mm vset(vo,C3): 
char vo /* 音色 番号 (1 一 200) */ 
char 計 ca: /* 音色 デー タ の 先頭 アド レス (55 バ イト ) */ 


FM 音源 の 音色 を 設定 し ます 。 
音色 デー タ の デー タ 形 式 (ca[Y][X]) 


の 潮 


0 |] ライ ィ ー ド バッ ク / ア ル ゴ リ ズム (0 一 63) (0 一 31) 
1 | スロ ッ ト マ スク (0 一 15) | D1R (0 一 31) 
2 | ウェ ュー ジン アホ ネー カム (0 一 3) | D2R (0 一 31) 
3 | ジン クロ (0.1) | RR (0 一 15) 
4 | 区 ビ ー ド (0 一 255) | D1L (0 一 15) 
5 う | PMD (0 一 127 | 理 (0 一 127 
6 | AMD (0 一 7 | KS (03) 
7 | PMS (0 一 3) | MUL (0 一 15) 
8 | AMS (Oce305 | DTI (0 一 7) 
9 


DT2 (0 一 3) 
AMS イ ネー プル (0,1) 


L, RPAN (0 一 3) 


mmー 
トー 


な お 、 オ ペレ ー タ 1 は M1 (モジ ュ レ ー タ 1) 、 オ ペレ ー タ 2 は C1 (キャ リア 
1) 、 オ ペレ ー タ 3 は M2 (モジ ュ レ ー タ 2) 、 お よび オペ レー タ 4 は C2 (キャ リ 
ア 2) に 対応 し て いま す 。 


正常 終了 の 場合 は 0 を 返し ます 。 
エラ ー の 場合 は 一 1 を 返し 、 そ の エラ ー コ ー ド は mm _errget 関 数 で 調べ る こと が 
飼 き ます 。 


m_vget 
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m_ VCOTT1 レベ ル 3 


書 式 #include く music3.h 


int m_ycom(md): 
int md /* ま Y コ マン ド の 使用 モー ド \*/ 


機 能 | md= ニ 0 で Y コ マン ド を MIDI の コン トロ ー ル デー タ と 解釈 し ます 。 
md 三 1 で Y コ マン ド を OPM レ ジス タ の 書き 換え と 解釈 し ます 。 
md に 一 1 また は "NAST を 指定 し た 場合 は 、 現 在 の モー ド を 返し ます 。 
(デフ ォ ル トミ テ 1) 


正常 終了 の 場合 は 0 を 返し ます 。 
エラ ー の 場合 は ー1 を 返し 、 そ の エラ ー コ ー ド は m_errget 関 数 で 調べ る こと が 
で きま す 。 
md に 一 1 また は "NAST を 指定 し た 場合 は 、 現 在 の モー ド を 返し ます 。 
(デフ ォ ル トミ テ 1) 
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3.。 3 OPMDRVS ウ イマ ラリ 
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GPIB ライ ブラ リ 


こと この節 で は 、GPIB ラ イブ ラリ の 使用 方 法 に つい て 説明 し ます 。 
な お GPIB ライ ブラ リ の ご 使用 に あたっ て は 、CONFIG.SYS へ 付属 の GPIBDRV.SYS の 登録 
を 行っ て くだ さい 。 ま た 、 以 下 の 点 に ご 注意 くだ さい 。 


1 . GPIB 関数 を ご 使用 の 場合 は 、 最 初 に 必ず gp_open( ) を 実行 し て くだ さい 。 
2 . GPIB 機能 の 使用 を 終了 し た 場合 は 、 必 ず gp_close( ) を 実行 し て くだ さい 。 


@ ラ イブ ラリ ー 覧 (アル ファ ベッ ト 順 ) 


名 前 機 能 具 
gpD_atnoff | ATN ラ イン を デー タモ ー ド に する ] 157 
gD_close GPIB 機能 の 使用 終了 の 宣言 157 
g_comout | 与え られ た コマ ンド の 送出 158 
gp_connect | トー カ ア ド レス 、 リ スナ アド レス の 設定 160 
gp_dcl DCLaYy ト ′ を 送出 し 、 接 続き れ て いる すべ て の デパ 人 12 を クリ ア 162 
gD_-eor デー タ 送 信 時 の デリ ミタ の 設定 163 
gpD_gl 指定 し た デバ イス を ロー カル 状態 に する 164 
gD_ifc IFC の 転送 時 間 の 設定 165 
gP_input デー タ の 受信 166 
gp_llo 接続 きれ て いる すべ て の デパ 7 が ゃ に :7 ル 状態 に な る の を 禁止 168 
gp_local REN ラ イン を n- 妙 状態 に し 、 ア デパ 信 の マニ >7 ル 状態 を 可能 に する 168 
gD_open GPIB 機能 の 使用 開始 の 宣言 、 初 期 化 169 
gD_output デー タ の 転送 171 
gp_remote | REN ラ イン を 呈 - ト 状態 に し 、 デ アパ 1 のり モート 制御 を 可能 に する 173 

_red ステ ー タ スバ イト の 送出 174 
gD_sdc 指定 し た デバ イス の クリ ア 175 
gD_sla 指定 し た デバ イス を リス ナ と する 176 
gD_SD シリ アル ポー ル の 実行 177 
gD_st4 トー カ の 指定 178 
gD_tanon ATN ラ イン を コマ ンド モー ド に する 178 

trg 指定 し た デバ イス に トリ ガ を か ける 179 
gD_ts GPIB の 状態 を 知ら せる 180 
gD_unl すでに 指定 きれ て いる リス ナ の 解除 181 
gD_unt すでに 指定 きれ て いる トー カ の 解除 181 
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3。 4 GPIB タマ イダ ラリ 


L9p_atnoffーーーーーーーーー で ミタ つ ) と 」 


書 式 | #nclude く gpib.h 


int gp _atnoff( ): 


ATN ラ イン を デー タモ ー ド に し ます 。 


| 9D_close (マス ター スレーブ) レベ ル 3 | 


六 nclude  。 ぐ gpib.h> 


int gpD_close( ): 
機 能 | GPrB 機能 の 使用 終了 を 宣言 し ます 。 


gpD_open と 対 で 使用 し ます 。 
GPIB の すべ て の 処理 が 終了 し た と き に 実行 し ます 。 


戻り 値 0……… 正常 終了 


人 02 関数 名 が 無効 
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(マス ター) レベ ル 3 


dp_Comout 


ぐ gpib.h 


ガ #include 


書 式 


int gp_comout(command): 


/* 送 出す る コマ ンド キネ */ 


int command: 


ンド を 送出 し ます 。 


与え られ た コマ 


能 


機 


・ 値 の 範囲 は 0 一 255 で す 。 
倫 タ イム アウ ト 時 間 は 10secc で す 。 


人 @command は 、 


以下 の と お り で す 。 


command・・・・・* 


3 


1 で 送受 信 さ れる ) 


(ATN 


る ス 


| | | と 4 ュ ィ ・ そ と 6 


次 コマ ンド 
グル ー プ (SCG) 


グル ー プ (PCG) 


一 次 コマ ンド ・ 
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3。 4 GPIB ライ ヲ ラリ 


〈①MSG= コマンド ノア ドレ ス 情 報 


(〈②b1=DIO1…b7 ニ DIO7 
⑨③ 二 次 コマ ンド を 伴う 
(④ 右 欄 は 、 コ マン ド プ アド レス 情報 を 示し 、 左 欄 は 対応 する ISO 一 7 ビッ 
ト ・ コ ー ド を 示す 。 
GTL : Gotolocal 
SDC : Select Device Clear 
PPC : Parallel Poll Configure 
GET : Group Execute Trigger 
TCT : TakeCpntrol 
LLO : LocalLockout 
DCL : Device Clear 
PPU : Parallel Poll Unconfigure 
SPE : Serial Poll Enable 
SPD : Serial Poll Disable 
UNL : Unlisten 


UNT : Untalk 
0………・ 正常 終了 
ー1・……・ パラ メー タ エ ラ ー 
ー2・・・・ ス レー プ ブ モ ー ド エ ラ ー 
vvv タイ ム ア ウ ト エ ラー 
ー6………・ 初期 化 エ ラー 


PE 関数 名 が 無効 


ATN 


DIO | 


COMMAND 
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| dgD_COnnect (マス ター) レベ ル 3 | 
jnclude ぐ gpib.h> 


int _connect(ta,lag): 
int (2: /※* ま トーカ アド レス キキ / 
int 玉 lag: /* ネ リ スナ アド レス 群 */ 


機能 トー カ ア ド レス (デー タ 送 信 ア デバ イス ) 、 リ スナ アド レス (デー タ 受 信 デ バ 


月 
イス ) の 設定 を 行い ます 。 
2 "の gpP_opne で 設定 し た my、dev の うち の ひと つの アド レス 。 
lag・…… 以下 の よう に 設定 し ます 。 


int lag(15) 三 (la1a2…。lan。 一 1 一 1… ぃ ーー1]: 
人 @1a1 一 Ian は 、 す べ て gp_opne で 設定 し た my、dev の うち に 含ま れ て 
いな けれ ば な り ま せん 。 
@jag 配列 の 添字 は か な ら ず 15 と し 、 デ バイ ス ア ドレ ス を 設定 し な い 
要素 に 、 一 1 を 入れ ます 。 タ イム アウ ト 時 間 は 1 0secc で す 。 


0……・ 正 常 終了 


Weezese パラ メー タ エ ラ ー 
2 Aoieeix 和 ドー ザ 二 一 ド エ タ ラー 
ー3……… タイ ム ア ウ ト エ ラー 
ー6・ー・ 初期 化 エ ラー 
ー7…・…・ 関 数 名 が 無効 


コン トロ ー ラ の デバ イス アド レス が 「 2」 で 、3 合 の 機器 (デバ イス アド レ 
ス : 5、7、20) が 接続 きれ て いる と き 、 コ ント ロー ラ か ら デ バイ ス ア ドレ 
ス 7 の 機器 に デー タ を 送信 し た い 場 合 。 


jadevi19] 三 { 5.720 一 1 ユー ルー エー1ー1ー ル ーー ルー ルー トー 1 
ag デリー ュー キー1 で あれ の で も ー ニ ーー ルー 一 トー トー に 


gpib_call( 
)( 
_Open(0,1,.2,deV): 
gp_cor(2,0x0d,Ox0a): 
gD_connect(2,1ag): 


gp_close(: 
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3。 4 GPIB ライ マラ 9 
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#include ぐ gpib.h 
int gp_dclO: 
DCL コ マン ド を 送出 し 、 接 続き れん て いる すべ て の デバ イス を クリ ア し ます 。 
信 タ イム アウ ト 時 間 は 10sec で す 。 
0・……・ 正常 終了 
ー2・・・・ 潤 レー プ ブ モー ド エ ラ ー 
9 vootve タイ ムアツ ウド エラ ー 
記章 4 su 初期 化 エ ラー 


ー7・・・ 関数 名 が 無効 
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ATN 


DIO 


3. 4 GPIB ライ ブラ リ 


| 9D_@O『 (マス ター ノ ス レ ー ブ ) レベ ル 3 | 
include ぐ gpib.h> 


int gp_eor(dlmtyp,dim0,dlm1): 

int dlImtyp: / ま デリ ミタ の 指定 キ */ 

int diIm0: /* ま デリミタ 文字 の 1 文字 目 ま / 
int dim1: / ま デリ ミタ 文字 の 2 文字 目 */ 


デー タ 送 受信 時 の デリ ミタ を 指定 し ます 。 
dImtryp に は 、 下 表 の 指定 が で きま す 。 


ソフ トウ ェ ア 転 送 


OUTPUT INPUT OUTPUT 
デリ ミタ 文字 な し 左 と 同じ 左 と 同じ 左 と 同じ 
また は EOI 


また は EOI 


2 dim0 と diml の 両方 | 左 と 同じ 左 と 同じ 
また は EOI また は EOI 
中 ロ 


3 デリ ミタ 文字 な し 左 と 同じ 左 と 同じ デリ ミタ 文字 な し 
また は EOI 


dlm0 
また は EOI 
dlm1 
また は EOI 


通常 、dIm 0 は CR (0x0d) 、dlm 1 は LF (0x0a) を 設定 し ます 。 


= 簡 Reeids 2 パラ メー タ エ ラ ー 
6oesse: 初期 化 エ ラー 
連 Re2e2 関数 名 が 無効 
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L9p_91 ト 一 ーーーーーーーーー で ぇ っ ) レベ ys | 


機能 


include ぐ gpib.h 


int gpD_gll(gtla): 
int 玉 glHla: /*GTL コ マン ド を 受け 取る デバ イス 群 */ 


指定 し た デバ イス を ロー カル 状態 に し ます 。 
e・** ェ ・ 以下 の よう に 設定 し ます 。 
int gtla[15] 三 {gdal,gtla2.…,gtlan, 一 1 一 1 一 1]: 
人 で gla1 一 gtlan は すべ て gp_open で 設定 し た dev う ち に 含ま れ て いな 
けれ ば な り ま せん 。 
條 ga 配列 の 添字 は か な ら ず 15 と し 、 デ バイ ス ア ドレ ス を 設定 し な 
ぃ 要素 に 、 一 1 を 入れ ます 。 
信 タ イム アウ ト 時 間 は 10sec で す 。 


0 正常 終了 
ー2…ー… スレ ー プ モー ド エ ラ ー 
ー3……… タイ ム ア ウ ト エ ラー 
ー6・・ーー・ 初期 化 エ ラー 


Ca 関数 名 が 無効 
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UNL MTA GTLAG GTL 


3。 4 GRIB ラ イダ ラリ 


ーー 


| dPD_I C (マス ター プス レー ブ ) レベル 3 | 
| 書 式 | #include ぐ gpib.h> 
能 


int gp _ifc(tcn0): 
int tcn  /* ま IFC を 転送 する 時 間 */ 


ま : ま さ 値 の 範囲 は 0 一 65535 で す 。 


| 書式 
tcnt の 単位 は 約 100 sec で す 。0 ま た は 、"NAST を 設定 し た 場合 、10msec と な り 


戻り 値 0 正常 終了 


ー 1・・・・ パラ メー タ エ ラ ー 
ー2・・・・・・ スレ ー プ モー ド エ ラ ー 
ー6・・・・・ 初期 化 エ ラー 


ー7……・ 関 数 名 が 無効 


に スシ ー ケ シス | 


| 一 100secXtcnt 一 | 
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| 9p_Input (マス ター スレ ー ブ ) レベ ル 3 | 


書 式 


機 能 
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#include 


ぐ gpib.h> 


int gp_input(datbuf,buflen,datlen,tcn0: 
char *datbuf:  / 半 受信 デー タ を 格納 する バッ ファ キ ギ / 


int buflen: /* 受 信 バ ッ フ ァ の サイ ズ キ ネ / 


int 玉 dadlent: / 受 信 デ ー タ 長 の ポイ ンタ */ 
int tcnb /※ ネ タイ ム ア ウ トカ ウン ト ネ */ 


デー タ の 受信 を 行い ます 。 


datbuf・‥・・ 


以下 の よ う に 定義 し ます 。 


char datbuf [buflen] : 
buflen (バッ ファ 長 ) は 最大 65535 バ イト で す 。 


datlen・…・ 


ー1・・・・・ 
ー3 PCE 室生 生 
ー4・・・・・・ 
ー5 PC 
ー6 PC まま 


正常 終了 、 バ ッ フ ァ フ ル (受信 デー タ が 、 バ ッ フ ァ 長 を 越え た 場 
合 。) 終了 の と き 、 受 信 さ れ た デー タ 数 を 返し ます 。EOS の 長 さ は 
含み ませ ん 。 

⑱ デ リ ミ タ 文字 が 指定 され て いる 場合 、 デ リ ミ タ 文字 は バッ ファ 
に 格納 され ます が 受信 デー タ 長 に 含ま れ ま せん 。 

単位 は 約 10msec で す 。 NAST の と き は 10sec と な り ま す 。 0 を 設 

定 し た 場合 は タイ ム ア ウ ト を 無視 し ます 。 値 の 範囲 は 、0 一 65535 

で す 。 

人 一度 に 受信 で きる 最大 の バイ ト 数 は 、6553S3 バ イト で す 。 そ れ 以 
上 の 連続 し た デー タ を 受信 する 場合 に は 、 バ ッ フ ァ フ ル 終 了 の 
後 、 再 び 実 行 し ます 。 そ れ を くり 返し 、 正 常に 終了 し た 時 点 で 、 
すべ て の デー タ を 受信 終了 し た こと に な り ま す 。 

信 こ の 関数 を 実行 する に は 、 リ スナ に 指定 し 、 か つ ATN ラ イン を 
OFF (デー タモ ー ド ) に する 必要 が あり ます 。 

人 正常 終 了 す る に は 、gp_eor で 設定 し た デリ ミタ と 、 送 信 側 か ら 送 
られ て きた デリ ミタ が 一 致し な けれ ば な り ま せん 。 


2 パラ メー クラー 
タイ ム ア ウ ト エ ラー 

2 バッ ※ ジ ドジ シェイ クボ ラー 
転送 中 断 エ ラー 
初期 化 エ ラー 


ーー ツェ rs 関数 名 が 無効 


3。 4 GPIB ライ ブラ 


プロ ダラ ム 倒 
プロ グラ ム 例 コン トロ ー ラ の デバ イス アド レス が 「2」 で 、3 台 の 機器 
(デバ イス アド レス : 5、7、20) が 接続 され て いる 時 、 デ バイ ス ア ドレ 
ス : 7 の 機器 か ら 65535 バ イト を 越え る デー タ を 受信 し た い 場 合 


#inclunde ぐ gpib.h> 
#define Buflen 65533 


int buf,dtlen: 

inRdev[1S] 三 9.720 王 1 デー ドー ルー ルー ュー リー トー1 も 1) 
ae ビビ 12、 一 リー ルー ルー ルー ュー1 ル デル デル リー ルー ュ ルー ミー リー ュー デー リト 
char dtbuf[Buflen]: 


gpib_call( 
){ 
_Open(0,1,2,dev) 
gpD_eor(2,0x0d,Ox0a) 
gD_connect(7,1ag): 
do 
buf 三 gp_input(dtbuf,Buflen,&&dilen,TNAST): 


]while(buf! 三 0): 
gpD_close(O: 
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| 遇 8 ! 提 一 ーーーー (マス ター) レベ ル 3 | 


1 


'e)) 


8 


書 式 


宙 include ぐ gpib.h> 


int gp_lloO: 


LLO コ マン ド を 送出 し 、 接 続き れ て いる すべ て の デバ イス が 以後 、 マ ニュ ア 
ル 状 態 に な る の を 禁止 し ます 。 
借 タ イム アウ ト 時 間 は 10sec で す 。 


一 人 の psise スレ ー ブ モ ー ド エラ ー 
ー3・・・・…・ タイ ム ア ウ ト エ ラー 
ー6・ー・ 初期 化 エ ラー 

ビー たい 関数 名 が 無効 


LLO 


nclude ぐ gpib.h> 


int gp_local0: 


REN ラ イン を ロー カル 状態 に し て 、 デ バイ ス の マニ ュ ア ル 状 態 を 可能 に し ま 
す 。 
0 正常 終了 
ー ク 2 旨い と レー ブ エ モー ド エ ラ ー 
ー6・… 初期 化 エ ラー 


3。 4 QPIB ラ イマ ザラ 


| dD_ODeTI (マス ター スレ ー ブ ) レベ ル 3 | 
include ぐ gpib.h> 


int gp_open(msflg,dmafigmy,dey): 
int msflg: / ま コン トロ ー ラ 機能 */ 
int dmflg: /*DMA 転 送 ネ / 
int my:  /* 自 分 の デバ イス アド レス ネネ / 
int 玉 dev: /* 接 続 さ れる すべ て の デバ イス アド レス キネ \/ 


機 能 | GPIB 機能 の 使用 開始 を 宣言 し 、 初 期 化 を 行い ます 。 


msflg eea2was マス ター モー ド (コン トロ ー ラ 機能 を 持ち ます 。) 
と スレ ー プ モー ド (コン トロ ー ラ 機能 を 持ち ませ ん 。) 
dmaflg ……… 0‥………・ ソ フト ウェ ア で デー タ 転 送 を 行い ます 。 
1… DMA で デー タ 転 送 を 行い ます 。 
my ……ー… (0 一 Ox1e) 
Beeue2 以下 の よう に 設定 し ます 。 


int dev(15) 三 【dev1,dev2,…,devn 一 1 一 1…, 一 11: 

人 接続 で きる デバ イス の 最大 数 は 15 で す 。 従っ て dev 配 列 の 添字 
は 必ず 15 と し て 、15 個 の 要素 を 定義 し ます 。 

の デバ イス アド レス を 設定 し な い 要 素 に 、 一 1 を 入れ ます 。 ま 
た 、 各 デバ イス アド レス は 、0 一 0xle で か つ 自 分 の デバ イス 
アド レス 以外 と し ます 。 

@ ス レー プ モ ー ド (msflg 三 1) の と き 、dev 配 列 の すべ て の 要 
索 に 、 二 中 を 大 れ ま す 。 


戻り 値 隊 2onooc 正常 終了 


ー 1・・ー・…・ 2 ジジ メータ エラ ー 
二 ea 関数 名 が 無効 
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コン トロ ー ラ の デバ イス が 「2」 で 、3 台 の 機器 (アバ イス アド レス : 5、 
7 、20) が 接続 され て いる 場合 


iabdef1 引 三 [ 72326. 一 1 ユー ルー ュー エー ュー も ーー ルー ュー キー ュー 紗 
gpib_call( 


){ 
gpD_open(0, 1 ,2,dev): 


gp_close0O: 
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3。 4 GPIB イプ ラリ 


| 9Dp_OUtDput (マス ター スレーブ) レベル 3 | 
#include ぐ gpib.h> 


int gP_output(datbuf,buflen,datlen,dImflg [,tcnt] ): 

char ネ ※ datbuf: /* 送 信 デ ー タ が 格納 され て いる バッ ファ の ポイ ンタ ネ ※/ 
int buflen: / 送 信 バ ッ フ ァ の サイ ズ キ ※\/ 

int datlen: / 玉 送信 デー タ 長 */ 

int dlmflg: / ま デリ ミタ を 付加 する か し な いか の フラ グ キ 半 / 

int tcnt: / ネ タイ ム ア ウ トカ ウン ト ネ */ 


デー タ の 転送 を 行い ます 。 
datbuf……・・ 以下 の よう に 定義 し ます 。 
char datbuf[buflen]: 
buflen (バッ ファ 長 ) は 最大 655353 バ イト で す 。 
datlen…… datbuf(0) か ら 何 バイ ト 送 信 す る か を 指定 し ます 。datbuf の 長 さ よ 
り daulen の 方 が 長い 場合 は 、datbuf の 長 さ が 送信 デー タ 長 と な り ま 


す 。 
dImflg……… NE 付加 し な い 。 
1 付加 する 。 
tcnt・・・・…・ 単位 は 約 10msec で す 。 ' NASI′ の 時 は 10sec と な り ま す 。 
0 を 設定 し た 場合 は 、 タ イム アウ ト を 無視 し ます 。 値 の 範囲 は 0 
ー65535 で す 。 


バッ ファ 長 を 越え る 連続 デー タ を 送信 する 場合 、 最 初 の 転送 を 含む 、 最 終 転 
送 で は な い 転 送 は デリ ミタ を 付加 せ ず に (dlmflg= 0 ) 行い 、 最 終 転送 で デリ 
ミタ を 付加 し て 行い ます 。 こ こ で 使用 する デリ ミタ は 、gp_eor で 設定 し ます 。 


@ この 関数 を 実行 する 前 に すでに トー カド に 指定 され て お り 、 か つ ATN ラ イン 
が OFF モ ー ド に な っ て いる 必要 が あり ます 。 


戻り 値 0……… 正常 終了 


ー1・ー・・・ パラ メー タタ エラー 
ー3………ー タイ ム ア ウ ト エ ラー 
ー4・・・・ ハン ド シ ェ イク エラ ー 
ー タ 5・・・・ 転送 中 断 エ ラー 
ー6・・・…・ 初期 化 エ ラー 


aza ym 関数 名 が 無効 


dl 
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プロ グラ ム 例 コン トロ ー ラ の デバ イス アド レス が 「2」 で 、3 人 台 の 機器 
(デバ イス アド レス : 5、7 、20) が 接続 きれ て いる と き 、 デ バイ ス ア ドレ 
ス ・ 7 の 機器 に 65533 バ イト を 越え る デー タ を 送信 し た い 場 合 


#include ぐ gpib.h> 
#define Buflen 65535 


int dtlen: 

dee 引 デ 5 720 一 ユー ュー ルー1ー エ ルー1 ル ーー ユー ユー ユー ルー11 
93 17。ー ニ ュー ユー デー ュ テー ュー ルー ルー 一 ルー も ルー! ルー トー ュー 康 三 あ 旧 に 
char dtbuf[Buflen]: 


gpib_call( 

){ 
gpD_open(0,1.2,dey) 
gp_eor(2,0x0d,Ox0a) 
gD_connect(2,1ag): 


gD_output(dtbuf,Buflen,dtlen,0,NAST): 


gD_output(dtbuf,Buflen,dtlen,1,NAST): 
gpD_close(): 


off デー タモ ー ド 
上 AEN 9 . 
oiLPULNHTTILIUU 1 JJ 
受信 デー タ 


3. 4 GPIB ライ ザラ リ 


| 9Dp_remote (マス ター) レベ ル 38 | 
##include ぐ gpib.h> 


int gp_remote(): 


| 機能 | REN ラ イン を リモ ー ト 状態 に し て 、 デ バイ ス の リモ ー ト 制御 を 可能 に し ま 


す 。 

戻り 値 Useozno 正常 終了 
呈 生 Away 入 レー ジー ド ギ デ ー 
ー6………・ 初期 化 エ ラー 


ーー7eweues 関数 名 が 無効 


REN 
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第 3 章 追加 ライ ブラ リ 


| dD_「@d (スレ ー ブ ) レベ ル 3 | 


書 式 


機 能 


include ぐ gpib.h 


int gp_req(stbda0: 
int stbda: / ネ SRO ス テー タス バイ トキ ※/ 


コン トロ ー ラ に サー ビス リク エス ト を 発行 し 、 ス テー タス バイ ト を 送出 し ま 
す 。 ま た サー ビス リク エス ト 要 求 の 終了 を 知ら せま す 。 
stbdat の 内 容 は 以下 の と お り で す 。 
6 ビッ ト 目 が 1‥…… gD_red (&BX1XXXXXX) 
stbdat を GPIB の シリ アル ポー ルモード レジ スタ に セッ 
ト し 、 サ ービス リク エス ト を 発行 し ます 。 
6 ビッ ト 目 が 0‥…… _red (&BXOXXXXXX) 
コン トロ ー ラ か ら の シリ アル ポー ル に より 、stbdat が 送 
出さ れ た か どう か を 返し ます 。 
(X ビ ッ ト : 自由 に 設定 可 ) 


We epe サー ビス リク エス トト 要求 が 終了 し た 。 

億 DA サー ビス リク エス ト 要 求 が 終了 し て いな い 。 
ー1・・…・ パラ メー タ エ ラ ー 
ー2・・・・・・ マス ター モー ド エ ラ ー 
ー6ー・ 初期 化 エ ラー 


ー7ー…・…・ 関 数 名 が 無効 


SRO 
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0 旨 間 六 | 


(た だ し 、stbdat の 6 ビッ ト 目 が セッ ト の と き ) 


3。 4 (PF 則 ライ プラ リ 


L9D_SdC 一 一 ーーーーーーーーー で で ぇ ター) レベ ル 3 | 
nclunde  。 ぐ gpibh> 


int gpD_sdc(sdca): 
int 玉 sdca: / ま SDC コ マン ド を 受け 取る デバ イス 群 */ 


指定 し た デパ イズ を み クリア し ます 。 
Sdca**・・ 以下 の よう に 設定 し ます 。 
int sdca[15] 三 [sdcal,sdca2.…,sdcan, 一 1 一 1…ー11: 
人 @cdca1 一 cdcan は すべ て gp_open で 設定 し た dev の うち に 含ま れ て な 
けれ ば な り ま せん 。 
@sdca 配 列 の 添字 は か な ら ず 15 と し 、 デ バイ ス ア ドレ ス を 設定 し な 
い ぃ 要素 に 、 一 1 を 入れ ます 。 


@ タ イム アウ ト 時 間 は 10sec で す 。 


0 正常 終了 
ー1・ーー・ パラ メー タ エ ラ ー 
ー2……・ スレ ー プ モー ド エ ラ ー 
ー3……… タイ ム ア ウ ト エ ラー 
We っ ps 初期 化 エ ラー 


tes 関数 名 が 無効 


UNL MTA SDCAG SDC 
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| dp_SIa (マス ター) レベ ル 3 | 
include  。 ぐ gpib.h> 


int gp_sla(la): 
int * 玉 la: / ネ リス ナ に 指定 され る アド レス 群 */ 


機 能 | 指定 し た デバ イス を リス ナ と し ます 。 
la・……・ 以下 の よう に 設定 し ます 。 
int la[15] 三 [la1,la2.…,lan, 一 1 一 1…, 一 1]: 
人 で ja1 一 n は すべ て gp_open で 設定 し た my、dev の うち に 含ま れ て いな 
けれ ば な り ま せん 。 
人 @ja 配 列 の 添字 は か な ら ず 14 と し 、 デ バイ ス ア ドレ ス を 設定 し な い 要 
素 に 、 一 1 を いれ ます 。 


人 @ タ イム アウ ト 時 間 は 10sec で す 。 


戻り 値 os 正常 終了 


ー1・・…・ パラ メー タ エ ラ ー 
の css s スレ ー プ エー ド エ ラ ー 
ー3…ー…ー タイ ム ア ウ ト エ ラー 
ー6・・ 初期 化 エ ラー 


ーーnwswe 関数 名 が 無効 


ATN 


DIO II Si ボ Po II 旧記 議 ! 詞 記 記 
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3 . 4 QPIB ラ イヴ ラリ 


| 9D_SD (マス ター) レベ ル 3 | 


書 式 nclude ぐ gpib.h 


int gp_SD(Sstbdat,srqdev): 
int 素 stbdat: /*SRO デ バイ ス か ら の ステ ー タ スバ イト キ */ 
int 玉 srqdev: /*SRO デ バイ ス の アド レス キネ ※/ 


機 能 | ソリ アル ポー ル を 実行 し ます 。 
stbda・・・・ リタ ー ン 時 に 、 セ ッ ト さ れ ま す 。 
srqdev・・・ リタ ー ン 時 に 、 セ ッ ト さ きれ ま す 。 一 1 が セッ ト さ れ た 場合 、SRO 
を 発行 し た デバ イス が 見 つか ら な か っ た こと を 意味 し ます 。 


但 シ リア ルポ ー ル を 実行 する た め に 、 指 定 さ れる デバ イス アド レス は 、 


gp_open で 設定 され た dev す べ て を 使用 し ます 。 
信 タ イム アウ ト 時 間 は 10sec で す 。 


戻り 値 gb 正常 終了 


ー]・……・ パラ メー タ エ ラ ー 
一 計 *rwoe レー ジン モー ドー 
ー3・・…・ タイ ム ア ウ ト エ ラー 
ー6ー・ 初期 化 エ ラー 


9 関数 名 が 無効 


ォ 


パス シー ケン シス 


SRQO ーー ーーーーーー ーー 
ATN | / ( | 


UNL MAL SPE TA1 STB1 TAn STBn SPD UNT 


0 メア 
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紀 PW き ーー (マス ター) レベ ル 3 | 
お nclnde ぐ gpib.h> 


int gD_Sta(t3): 
int ta: / ま トー カ ア ド レス キキ / 


機 能 | トー カ を 指定 し ます 。 
1 0 一 0xle の 値 を と り ま す 。 gp_open で 設定 し た my、devy の うち に 含ま れ 
て いな けれ ば な り ま せん 。 
人 @ タ イム アウ ト 時 間 は 10sec で す 。 


戻 り 値 0 ドー・ 正常 終了 


ー1・・・・・・ パラ メー タ エ ラ ー 
ー2・・・・・・ スレ ー プ モー ド エ ラ ー 
ー3…ー… タイ ム ア ウ ト エ ラー 
ー6・・ 初期 化 エ ラー 


suas 関数 名 が 無効 


int gp_atnon( ): 


ATN ラ イン を コマ ンド モー ド に し ます 。 
| 戻り 値 | 


ー6*・……・ 初期 値 エ ラー 
7 グ ee ee 関数 名 が 無効 


1 


こ J 


8 


3。 4 GPIB 逐 イダ ラ 9 


| 9D_trd (マス ター) レベ ル 3 | 
#include ぐ gpib.h> 


int gp_trg(trga): 
int trga: / ま GET コ マン ド を 受け と る デバ イス 群 */ 


機 能 | 指定 し た デバ イス に トリ ガ を か け ま す 。 
trga・・ 以下 の よう に 設定 し ます 。 
int irga[13] 三 (trgal,rga2,…,trgan, 一 1 一 1… ッ ーー1]: 
人 で rga1 一 rgan は すべ て gp_open で 設定 し た dev の うち に 含ま れ て い 
な けれ ば な り ま せん 。 
人 @rga 配 列 の 添字 は か な ら ず 15 と し 、 デ バイ ス ア ドレ ス を 設定 し な 
い 要 素 に 、 一 1 を 入れ ます 。 


倫 タ イム アウ ト 時 間 は 10sec で す 。 


戻 り 値 0……・ 正常 終了 


ー1…・…・ パラ メー タ エ ラ ー 
ー2・・…・ スレ ー プ モー ド エ ラ ー 
Yovco ダイ あみ ア ウト エラ ー 
絡 we 初期 化 エ ラー 


3 が 82eioieie 関数 名 が 無効 


ATN 


po て TTF IT コー で 


UNL MTA TRGAG GET 


179 


第 3 章 追加 ライ ブラ リ 


| dD_tS (マス ター プス レー ブ ) レベ ル 3 | 
nclnde  。 ぐ gpib.h> 
int gpD_s(O: 


GPIB の 状態 を 知ら せま す 。 


戻り 値 (関数 値 ) に 、 状 態 が 返さ れ ま す 。 下位 8 ビッ ト は 次 の 意味 を 持ち ま 


SOR 
DCL/ SDC 
GET 
LOK 
REM 
MLA 
MTA 


SRO…… マス ター モー ド で 、 他 の デバ イス か ら SRO メ ッ セ ー ジ が きた と き 
に セッ ト さ れ ま す 。 

DCL/SDC… ス レー プ モ ー ド で 、 コ ント ロー ラ か ら DCL ま た は SDC コ マン ド が 
送ら れ て きた 時 に セッ ト し ます 。 


GET・…… スレ ー プ モー ド で 、 コ ント ロー ラ か ら GET コ マン ド が 送ら れ て き 

だ と どき に セッ トト し ます 。 

LOK ・…… スレ ー プ モー ド で ロッ クア ウト 状態 に ある こと を 示し ます 。 

REM・…… スレ ー プ モー ド で リモ ー ト 状態 に ある こと を 示し ます 。 

MLA・・… スレ ー プ モー ド で リス ナ デ バ イス に 指定 され て いる 場合 に セッ ト 
され ます 。 

MTA・‥…… スレ ー プ モー ド で トー カ デ バ イス に 指定 され て いる 場合 に セッ ト 
され ます 。 

OxOO0XX (XX に つい て は 機能 を ご 参照 くだ さい 。 ) 
ー6・・・…・ 初期 化 エ ラー 


se 関数 名 が 無効 
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3. 4 GPIB ライ ブラ リ 


| gp_unl (マス ター) レベ ル 3 | 


5 語 #inclunde ぐ gpib.h 


int gp_unl(): 


すでに 指定 され て いる リス ナ を 解除 し ます 。 
| 戻り 値 | 


倫 タ イム アウ ト 時 間 は 10sec で す 。 


ー2……… スレ ー プ モー ド エ ラ ー 
9wzsm タイ ム ア ウ ト エ ラー 
ー6・・・ 初期 化 エ ラー 


ー7・ー…・ 関 数 名 が 無効 


| 9D_Uunt (マス ター) レベ ル 3 | 
久 nclude ぐ gpib.h> 


int gD_un((): 


能 | すでに 指定 さん て いる トー カ を 解除 し ます 。 
倫 タ イム アウ ト 時 間 は 10sec で す 。 


2 紀 25 スス シープ モー ド エ ラ ター 
mt ダイ オム アウ ルト エマ ター 
ー 仙 ba 初期 化 エ ラー 


wonant 関数 名 が 無効 
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SGS+ ラ イブ ラリ 


「Ccompiler PRO-68K ver2.1 NEW KIT|] で は 、SCSI に 対応 し た ライ プラ リ が サポ ー ト さ 
れ て いま す 。 
これ に より 、 新 し く 次 の ファ イル が 追加 変更 され て いま す 。 


ファ イル 名 内 容 

IOCSLIBL IOCS コ ー ル ライ プラ リ (SCSI 対 応 ) 
IOCSLIB.H IOCS コ ー ル 関数 の 定義 (SCSI 対 応 ) 
IOCSCALL.MAC | IOCS コ ー ル の ヘッ ダフ ァイル (SCSI 対 応 ) 
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3 。 5SCSI ラ ウイ ブラ リ 
人 @ ライ ブラ リー 覧 (SCSI 番 号 順 ) 
SCST 番 号 | 7 関数 名 機 能 | 頁 
$00 S_RESET SPC(SCSI プ ロト コル コン トロ ー ラ ) お よび | 190 
SCSI バ ス の リセ ッ ト 
$01 S_SELECT アー ビ ト レー ショ ン フ ェ ー ズ と セレ クシ ョ ン | 192 
フェ ー ズ の 実行 
$03 S_ CMDOUT コマ ンド アウ ト フ ェ ー ズ の 実行 184 
$04 S_DATAIN デー タイ ン フ ェ ー ズ の 実行 184 
$05 S_DATAOUT デー タ ア ウト フェ ー ズ の 実行 185 
$06 S_STSIN ステ ー タ スイ ン フ ェ ー ズ の 実行 193 
$07 S_MSGIN メッ セー ジイ ン フ ェ ー ズ の 実行 186 
$08 S_MSGOUT メッ セー ジア ウト フェ ー ズ の 実行 187 
$09 S_PHASE フェ ー ズ セン ス 188 
$20 S_INOUIRY INQUIRY デ ー タ の 要求 186 
$21 S_READ SCSI 装 置 よ り デ ー タ の 読み 込み 188 
$22 S_WRITE SCSI 装 置 へ の デー タ の 書き 込み 194 
$23 S_ FORMAT SCSI 装 置 の フォ ー マ ッ ト 185 
$24 S_ TESTUNIT SCSI 装 置 が 動作 可能 で ある か どう か の 194 
調査 
$25 S_READCAP SCSI 装 置 の 容量 に 関す る 情報 の 調査 189 
$26 S_READEXT 拡張 READ コ マン ド 189 
$27 S_ WRITEEXT 拡張 WRITE コマ ンド 195 
$2b S_REZEROUNIT | SCSI 装 置 を 指定 の 状態 に セッ ト 191 
$2c S_REOUEST SCSI 装 置 の セン ス デ ー タ の 調査 191 
$2d S_SEEK 指定 の 論理 プロ ッ ク ア ドレ ス へ の シー ク 192 
$2f S_STARTSTOP |SCSI 装 置 に 対し て 以降 の 操作 の 可能 / 193 
不可 能 の 要求 
$31 S_REASSIGN 欠陥 プロ ッ ク の 割り 当て の 要求 190 
$32 S PAMEDIUM | メデ ィ ア の イジ ェクト の 禁止 ・ 許 可 の 設定 187 
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上 靖幸 間 0000 ま ーーーー ーーーーーー ae 
nclnde ぐ iocslib.h> 


int S_ CMDOUTBYTE,CDBADDR): 
int BYTE: / ネ コマ ンド の バイ ト 数 */ 
unsignedchar CDBADDR:  /*CDB の 先頭 アド レス キネ */ 


コマ ンド フェ ー ズ を 実行 し ます 。 

CDB(Command Discriptor Block) の 先頭 アド レス か ら そ の コマ ンド の バイ ト 数 
分 の デー タ を SCSI バ ス 上 に 出力 し ます 。 

グル ー プ 0/1/5 以 外 の コマ ンド の と き は 、BYTE に コマ ンド の バイ ト 数 を 指定 し 
で くだ き Mw 


戻り 値 | エラ ー コ ー ド を 返し ます 。 (「5. 3 エラ ー コ ー ド 」 参照 ) 


DA ん 0 間 エーーーmmm ア ーー mmmys zo ] 
include ぐ iocslib.h> 


機 


人 


E 


int S_ DATAIN(BYTE,ADDRESS): 
int BYTE: /* 読み 込み バイ ト 数 */ 
unsignedchar ※ADDRESS:  /* 読 み 込 み 先頭 ア ドレ スキ */ 


デー タイ ン フ ェ ー ズ を 実行 し ます 。 
ADDRESS で 指定 し た ア ドレ ス へ BYTE で 指定 し た バイ ト 数 分 の デー タ を SCSI 
バス 上 か ら 読 み 込み ます 。 


鹿 値 | エラ ー コ ュー ぜ を 反し ます 。 (T5。 8 エニ ラー コー ザ ] 服 ) 
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LS_DATAOU「ーーーーーーーーー て yo] 
nclnde ぐ iocslib.h ン 


int S_DATAOUT(BYTE,ADDRESS): 
int BYTE: /* 書 き 込 み バ イト 数 * ネ / 
unsigned char ※ ま ADDRESS: /* 書 き 込 み 先頭 アド レス キネ */ 
機 能 | アー タク アウ ト フ ェ ュー ズ を 素行 し ます 。 
ADDRESS で 指定 し た アド レス か ら BYTE で 指定 し た バイ ト 数 分 の デー タ を 
SCSI バ ス 上 へ 書き 込み ます 。 


戻り 値 | エラー ヨー ド を 返し ます 。 (5。 3 エラ ー コ ヨー ド ] 参照) 


FLS_FORMA キ ーーーーーーーーー ジ eo] 
和 nclude iocslib.h> 


int S_ FORMAT(INTERL,ID): 
int INTERL: / ネ イン ター リー プ 六 / 
int ID: / ネ ター ゲッ ト ID*/ 


指定 の イン ター リー プ 値 で SCSI 装 置 を フォ ー マ ッ ト し ます 。 
戻り 値 ステ チー タス を 和 し ます 。 


(上 位 ニ メッ セー ジイ ン フ ェ ー ズ で 得 た 情報 下位 ニス テー タス イン フェ ー 
ズ で 得 た 情報 ) 
ー1 な ら 上 異常 終了 
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ーー は あす な 
#inclnde ぐ iocslib.h 


int S_INQUIRY(BYTE,ID,inq): 

int BYTE: /* 読み 込み バイ ト 数 */ 

int ID: / ネ ター ゲッ ト の ID*/ 

struct INOUIRY ※*ind: /* 読 み 込み 先頭 アド レス ※\/ 


機 能 | inq で 示す アド レス に 、BYTE で 指定 し た バイ ト の INQUIRY デ ー タ を 読み 込み 
ます 。 


siruct INOUIRY { 


unsigned char uni: /* 周辺 装置 機種 */ 

unsigned char info: /* RMB! 機 種 限定 */ 

unsigned char ver: /**ISOiECMAIANSI バ ー ジ ョ ン 玉 / 
unsigned char reserve: /\ 保 留 */ 

unsigned char size: /* 追 加 長 */ 

unsigned charbuff [| : / キ ペン グー ユニ ー ク キキ / 


}: 
戻り 値 | ステ ー タ ス を 返し ます 。 (上 位 ニ メッ セー ジイ ン フ ェ ー ズ で 得 た 情報 下位 


ニス テー タス イン フェ ー ズ で 得 た 情報 ) 
ー1 な ら 異 常 終 了 


LS_MSGINーーー ーー パー バー と < ] 
震 nclnde ぐ iocslib.h 


int S_MSGIN(ADDRESS): 
unsignedchar ※ ま ADDRESS: / キ 読み込み 先頭 アド レス *\/ 


機 能 | メッ セー ジイ ン フ ェ ー ズ を 実行 し ます 。 


ADDRESS で 指定 し た アド レス へ 1 バイ ト の デー タ を SCSI バ ス 上 か ら 読 み 込 み 
ます 。 


戻り 値 | エラ テー コー ド を 返し ます 。 (「5. 3 エラ ー コ ー ド ]」 参照 ) 
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FS_MSGOUT キ ーーーーーーーーー セ oo 」 
#include ぐ iocslib.h> 
int S_MSGOUT(ADDRESS): 


unsigned char ま ADDRESS: /* 読み 込み 先頭 アド レス ネ */ 


機 能 | メッ セー ジア ウト フェ ー ズ を 実行 し ます 。 
ADDRESS で 指定 し た アド レス か ら 1 バイ ト の デー タ を SCSI バ ス 上 へ 書き 込み 
ます 。 


戻り 値 | エ テ ラー コ ー ド を 返し ます 。 (「5. 3 エラ ー コ ー ド 」 参照 ) 


LS_PAMEDIUMーーーーーーーー 
書 式 | #include ぐ jocslib.h> 


int S PAMEDIUM(MODE,ID): 
int MODE: /*0: イ ジェ クト 許可 プ 1: イ ジェ クト 禁止 * ネ / 
int ID: /※ ネ ター ゲッ ト の ID*/ 


メデ ィ ア の イジ ェクト の 禁止 許可 を 設定 し ます 。MODE が 0 の と き イ ジェ 
クト 許可 、 1 の と き イ ジェ クト 禁止 に 設定 し ます 。 


ステ ー タ ス を 返し ます 。 
(上 位 ミ メッ セー ジイ ン フ ェ ー ズ で 得 た 情報 下位 ニス テー タス イン フェ ー 
ズ で 得 た 情報 ) 
ー1 な ら 異 常 終了 
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S_ PHASE 
#inclnde ぐ jocslib.h> 


int S_PHASE(void): 


機 能 | フェ ー ズ を セン ス し ます 。 
SPC の PSNS レ ジス タ を 読み だ し ます 。 


戻り 値 | 現在 の フェ ー ズ を 返し ます 。 


っ S READ ンマ 
nclude iocslib.h> 


int S READ(POS,BLOCK,ID,SIZE,ADDRESS): 

int POS: /* 目 的 読み 込み 位置 (論理 プロ ッ ク 番 号 ) */ 
int BLOCK: /* 読 み 込 み プ ブロック 数 (論理 プロ ッ ク 数 ) */ 
int ID: / ネ ター ゲッ ト の ID*/ 

int SIZE: /* 1 プロ ッ ク の 容量 (0256/1 三 512/2 三 1024) 
ネ / 


unsigned char *ADDRESS: /* 読 み 込み 先頭 アド レス ※\/ 


POS で 指定 し た 論理 プロ ッ ク 番 号 か ら BLOCK で 指定 し た プロ ッ ク 分 の デー タ 
を ADDRESS で 指定 し た アド レス へ 読み 込み ます 。 
1 プロ ッ ク の 容量 は 3 以上 を 指定 で きま せん 。 


ステ ー タ ス を 返し ます 。 
(上 位 ニ メッ セー ジイ ン フ ェ ー ズ で 得 た 情報 下位 ニス テー タス イン フェ ー 
ズ で 得 た 情報 ) 
ー1, 一 2 な ら 異 常 終了 
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3。 590 條 セイブ ラリ 


に SEAUOA am 寺 寺 el 


書 式 nclude ぐ iocslib.h> 


int S_READCAP(ID,capa): 
int ID: / ネ ター ゲッ ト ID*/ 
struct READCAP capa /* 読 み 込 み 先頭 アド レス ネ */ 


機 能 | capa で 示す アド レス に 8 バイ ト の READ CAPACITY デ ー タ を 読み 込み ます 。 
struct READCAPA [ 
unsigned int block: /* 論 理 プ ロッ クア ドレ スポ / 
unSigned int size: / ネ ブロ ッ ク 長 */ 
久 デ ー タ ス を 返し ます 。 
(上 位 三 メッ セー ジイ ン フ ェ ー ズ で 得 た 情報 / 下 位 ニ ステ ー タ スイ ンプ フェー 
ズ で 得 た 情報 ) 
ー1 な ら 異 常 終 了 


DO 
nclude ぐ iocslib.h> 


int S READEXT(POS,BLOCK,ID,SIZE,ADDRESS): 

int POS: /* 目 的 読み 込み 位置 (論理 プロ ッ ク 番 号 ) */ 
int BLOCK: /* 読 み 込 み ブ ロッ ク 数 (論理 プ ブロッ ク 数 ) */ 
int ID: / ネ ター ゲッ ト の ID*/ 

int SIZE: /* 1 プロ ッ ク の 容量 (0 三 256/1 三 512/2 三 1024) 
玉 / 


unsigned char ※ADDRESS: /* 読 み 込み 先頭 アド レス ※/ 


機 能 | POS で 指定 し た 論理 プ ブロッ ク 番 号 か ら BLOCK で 指定 し た プロ ッ ク 分 の デー タ 
を ADDRESS で 指定 し た アド レス へ 読み 込み ます 。 
グル ー ブ 1 の コマ ンド 。 
読み 込み ブロ ッ ク 長 は 65,535 プ ロッ ク ま で 指定 可能 。 
1 プロ ッ ク の 容量 は 3 以上 を 指定 で きま せん 。 


ステ ー タ ス を 返し ます 。 
(上 位 ニ メッ セー ジイ ン フ ェ ー ズ で 得 た 情報 / 下 位 ニ ミス テー タス イン フェ ー 
ズ で 得 た 情報 ) 
ー1, 一 2 な ら 異 常 終了 
189 


第 3 章 追加 ライ ブラ リ 


S REASSIGN レー 
nclnde ぐ iocslib.h> 


int S REASSIGN(BYTE,ID,ADDRESS): 
int BYTE: /* 書 き 込 み バ イト 数 */ 
int ID: / ネ ター ゲッ ト の ID*/ 


unsigned char ADDRESS:  /* 書 き 込み 先頭 アド レス ネ / 


機 能 | 欠陥 プロ ッ ク の 再 割り 当て を 要求 し ます 。ADDRESS で 指定 し た アド レス か ら 
BYTE で 指定 し た バイ ト 数 の REASSIGN BLOCKS デ ー タ を 書き 込み ます 。 


戻り 値 | ステ ー タ ス を 返し ます 。 (上 位 ニ メッ セー ジイ ン フ ェ ー ズ で 得 た 情報 下位 


ーー ステー タス イン フェ ー ズ で 得 た 情報 ) 
ー1 な ら 凌 常 終了 


S_ RESET レン の o 
#include jocslib.h ラ 


void S_RESET( ): 

機 能 | SPC (SCSI プ ロト コル コン トロ ー ラ ) の 初期 化 、SCSI バ ス の リセ ッ ト を 行い 
ます 。 
SCSI バ スリ セッ ト 後 に 2 秒間 待機 し ます 。 


戻り 値 | 戻り 値 は あり ませ ん 。 
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FLS_REQUES「 一 ーーーーーーー ア we 」 
#include ぐ iocslib.h> 


int S_ REOUEST(BYTE,ID,ADDRESS): 
int BYTE: /* 読 み 込み バイ ト 数 */ 
int ID: / キ ター ゲッ ト の ID*/ 


unsigned char ※ADDRESS: /\* 読 み 込み 先頭 アド レス \/ 


機 能 | ADDRESS で 指定 し た アド レス へ BYTE で 指定 し た バイ ト 数 の REQUEST 
SENSE デ ー タ (SCSI 装 置 の セン ス デ ー タ ) を 読み 込み ます 。 


戻り 値 | ステ ー タ ス を 返し ます 。 (上 位 ミ メッ セー ジイ ン フ ェ ー ズ で 得 た 情報 下位 
ー ス テー タス イン フェ ー ズ で 得 た 情報) 
ー1 な ら 異 常 終了 


FS_REZEROUNITーーーーーーー て < 
include ぐ iocslib.h> 


int S REZEROUNITD): 
int ID: / ネ ター ゲッ ト の ID*/ 


機 能 | SCSI 装 置 を 指定 の 状態 に セッ ト す る こと を 要求 し ます 。 
指定 の 状態 は 各 装置 の 取扱 説明 書 を 参照 し て くだ さい 。 


戻り 値 | ステ ー タ ス を 返し ます 。 (上 位 = ミ メッセージ イン フェ ー ズ で 得 た 情報 下位 


ー ス テー タス イン フェ ー ズ で 得 た 情報 ) 
ー1 な ら 異 常 終了 
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nclnde ぐ iocslib.h> 


int S_SEEK(POS,ID): 
int POS: /* 目 的 シー ク 位 置 (論理 プロ ッ ク 番 号 ) */ 
int ID: / キ ター ゲッ ト の ID*/ 


POS で 指定 し た 論理 プロ ッ ク 番 号 に シー ク し ます 。 


戻り 値 | ステ メータ ス を 返し ます 。 (上 位 ニ メッ セー ジイ ン フ ェ ー ズ で 得 た 情報 ノ 下 位 
ー ス テー タ スイ ン フ ェ ー ズ で 得 た 情報 ) 


ー1 な ら 異 常 終了 


#include ぐ iocslib.h> 


int S_ SELECT(ID): 
int ID: / ネ ター ゲッ ト ID*/ 


アー ビ ト レー ショ ン フ ェ ー ズ と セレ クシ ョ ン フ ェ ー ズ を 実行 し ます 。 
戻り 値 | エラー コー ド を 返し ます 。 (「5. 3 エラ ー コ ー ド 」 の 参照) 
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上 S_ST「ARTSTO ピ ーーーーーーーー と oe 」 
#include ぐ iocsib.h> 


int S STARTSTOP(MODE,ID): 
int MODE: /*0: 操 作 不 可 プ 1: 操 作 可 * ま / 
int ID: / キ ター ゲッ ト の ID※*/ 


機 能 | sCsT 装 置 に 対し て 以降 の 操作 を 可能 、 ま た は 操作 を 不可 能 に する こと を 要求 
し ます 。 MODE が 1 の と き は SCSI 装 置 を 操作 で きる よう に 設定 し 、 ま た 0 の 
と き は SCSI 装 置 を 停止 (操作 不可 ) する よう に 要求 し ます 。 

戻り 値 | ステ ー タ ス を 返し ます 。 (上 位 ニ メッ セー ジイ ン フ ェ ー ズ で 得 た 情報 下位 


ー ス テー タス イン フェ ー ズ で 得 た 情報 ) 
ー1 な ら 異 常 終 了 


Winclude ぐ jocslib.h> 


int S_STSIN(ADDRESS): 
unsigned char ※ADDRESS: /* 読み 込み 先頭 アド レス */ 


機 能 | ステ ー タ スイ ン フ ェ ー ズ を 実行 し ます 。 


ADDRESS で 指定 し た アド レス へ 1 バイ ト の デー タ を SCSI バ ス 上 か ら 読 み 込み 
ます 5 


戻り 値 | エラ ー コ ー ド を 返し ます 。 (「5. 3 エラ ー コ ー ド 」 の 参照 ) 
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RS レベ ル 0 
#include く iocslib.h> 


int S_TESTUNITD): 
int ID: / キ ター ゲッ ト 1ID/ 


機 能 SCSI 装 置 が 動作 可能 で ある か を 調べ ます 。 戻り 値 が NULL の と き に の み 動 作 
可能 で す 。 


戻り 値 | ステ ー タ ス を 返し ます 。 (上 位 ニ メッ セー ジイ ン フ ェ ー ズ で 得 た 情報 下位 


ニス テー タス イン フェ ー ズ で 得 た 情報 ) 
ー1 な ら 異 常 終了 


S_ WRITE ーー 
nclude ぐ jocslib.h> 


int S WRITE(POS,BLOCK,ID,SIZE,ADDRESS): 

int POS: /*\ 目的 書き 込み 位置 (論理 プロ ッ ク 番 号 ) */ 
int BLOCK: /\* 書き 込み プロ ッ ク 数 (論理 プロ ッ ク 数 ) */ 
int ID: / ネ ター ゲッ ト の ID*/ 

int SIZE: /* 1 プ ブロック の 容量 (0=256/1 三 512/2 三 1024) 
ギ ま / 


unsignedchar ※ADDRESS: /* 書 き 込 み 先頭 ア ドレ スキ */ 


機 能 | POS で 指定 し た 論理 プロ ッ ク 番 号 か ら BLOCK で 指定 し た プロ ッ ク 分 の デー タ 
を ADDRESS で 指定 し た アド レス か ら 書 き 込 み ま す 。 
1 プ ブロッ ク の 容量 は 3 以上 を 指定 で きま せん 。 


戻り 値 | ステ ー タ ス を 返し ます 。 (上 位 ニ メッ セー ジイ ン フ ェ ー ズ で 得 た 情報 / 下 位 


ー ス テー タス イン フェ ー ズ で 得 た 情報 ) 
ー1, 一 2 な ら 異 常 終了 
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LS_WRITEEX「ーーーーーーーー ン で 
include ぐ jiocslib.h> 


int S_ WRITEEXT(POS,BLOCK,ID,SIZE,ADDRESS): 

int POS: /* 目 的 書き 込み 位置 (論理 プロ ッ ク 番 号 ) */ 
int BLOCK: /* 書 き 込 み プ ロッ ク 数 (論理 プロ ッ ク 数 ) */ 
int ID: / ネ ター ゲッ ト の ID*/ 

int SIZE: /* 1 プロ ッ ク の 容量 (0 三 256/1 三 512/2 三 1024) 
ネ / 


unsignedchar 玉 ADDRESS: /* 書 き 込み 先頭 アド レス キキ / 


機 能 | POS で 指定 し た 論理 ブロック 番号 か ら BLOCK で 指定 し た ブロ ッ ク 分 の デー タ 
を ADDRESS で 指定 し た アド レス へ 書き 込み ます 。 
グル レーヴ 1] の コマ シン ド 。 
書き 込み プロ ッ ク 長 は 65,535 プ ロッ ク ま で 指定 可能 。 
1 プロ ッ ク の 容量 は 3 以上 を 指定 で きま せん 。 


戻り 値 | ステ ー タ ス を 返し ます 。 (上 位 ニ メッ セー ジイ ン フ ェ ー ズ で 得 た 情報 下位 


デース テー タス イン フェ ー ズ で 得 た 情報 ) 
ー1, 一 2 な ら 異 常 終了 
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店 写 記 詞 記 訪 記 記 に 記 ボ ポ 訂 記 ポ に 半 に ド ュ ンー 


ョ マト IE 王 ニ ーー 


kai 


円 IM 


本 自 
は 上 
記 


mm 


Lc 

遇 | 還 『 
LU 
Mi 


中 すい 


中 


支間 ] 


絹 4 章 
追加 DOS プ IOCS コ ー ル 


拡張 DOS コ ー ル 
拡張 )OCS コ ー ル 
OPMDRV3 IOCS コール 
SCSI IOCS コ ー ル 
拡張 RS-232CIOCS コ ー ル 


拡張 DOS コ ー ル 


と と で は 、Human68k ver.3.0 で 新規 に 追加 され た 、 も し く は 拡張 され た DOS コ ー ル を 説明 
し TGVA ま 66 


従来 の DOS コ ー ル の $FFS0 か ら $FF7F ま で は 、MC68EC030 で は cpRESTORE 命 令 と 判断 さ 
れ 、 ア ドレ ッ シ ン グ に よっ て は F 系 列 の 未定 義 処理 に いく 前 に バス エラ ー を 起こ すこ と が 
あり ます の で 、 同 じ 処 理 を $FF80 か ら $FFAF で も 実行 で きる よう に し て いま す 。 

ユー ザー モー ド で 動作 する 場合 に は 、 こ と これ ら の コー ル は バス エラ ー の 前 に 特権 違反 が 先 
に 発生 する た め 、$FF50 か ら $FF7F で も 正しく 処理 され ます が 、 ス ー パ ー バ イザ ー モ ー ド 
で 動作 し て いる 場合 は その と き の レ ジス タ の 値 に より バス エラ ー が 発生 し た り し な か っ 
た り し ます の で 、 今 後 は 、X68K シ リー ズ で 共通 に 作動 する プロ グラ ム に する た め 、 

$FF80 か ら $FFAF を 使用 する よう に し て くだ さい 。 


その た め 新 し く DOSINIT() 関 数 が 、"CLIBL" に 用 意 さ きれ て いま す 。 各 DOS コ ー ル を 呼ぶ 
前 に 、 こ の 関数 を コー ル す る こと に より 、 ど の バー ジョ ン の OS で も 新しい DOS コ ー ル 番 
号 で 使用 する こと が 可能 と な り ま す 。 

__MAIN.O か ら 始 まる プロ グラ ム で な い 通 常 の アセ ンプ ラプ ログ ラム を 書く 場合 で 、 
スー パー バイ ザー モー ド で 参照 関数 を アク セス する 可能 性 が ある と き は 、 必 ず こ の 関数 
を コー ル し た 後 で 使用 する よう に し て くだ さい 。 

詳し く は 、「3.1 拡張 DOS コ ー ル ライ ブラ リ 」| の DOSINIT( ) を ご 参照 くだ さい 。 


@ ラ イブ ラリ ーー 覧 (アル ファ ベッ ト 順 ) 


名 前 機 能 真 | 
breakck プレ ー ク チェ ッ ク の 設定 208 
close ファ イル ハン ドル の クロ ー ズ 200 
create ファ イル の 新規 作成 199 
fflush_set fflush の 有効 ・ 無 効 の 制御 205 
files ファ イル の サー チ 201 
get_fcb_adr 指定 の ファ イル ハン ドル の FCB の 先頭 アド レス を 得る | 207 
ioctl デバ イス ドラ イ バ の ダイ レク ト 入 出力 210 
malloc2 メ モリ の 指定 し た 方 法 で の 確保 215 
nfiles 次 の ファ イル の サー チ 203 
os_patch FASTIOFASTOPENFASTSEEK の 登録 制御 206 
s_malloc メイ ン メ モリ 管理 下 の メ イン ブロ ッ ク 確 保 217 
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4. 1 拡張 DOS コ ー ル 


create ェ ーー 


人 @create(NAMEPTR,ATR) DOS コ ー ル 番号 : $FF3C 


ファ イル を 作成 し ます 。 


引 数 | NAMEPTRG) address 文字 列 (ファ イル 名 ) へ の ポイ ンタ 


ATR(r) word ファ イル 属性 
MOVE.W ATR, 一 (SP) 
PEA NAMEPTR 
DC.W _CREATE 


ADDQL  #6.SP 


NAMEPTR:DC.B 'A:\DOC\TEST.DOC',0 


DOL 作成 し た ファ イル の ファ イル ハン ドル 


I ーー 
ナタ DOE く 0… エ ジー ヨード 


Ne 


ー 新しい ファ イル を 作成 し ます 。 シ ェアリング モー ド は ロン パチ デル と し て 披 
われ ます 。 NAMEPTR で 指定 し た ファ イル 名 が すでに 存在 し て いる 場合 に 
は 、 前 の ファ イル の 内 容 は 失わ れ ま す 。 
ATR に は 、 作 成す る ファ イル の 属性 を 指定 し ます 。 
ATR の 各 ビ ッ ト は 次 の 通り で す 。 


b15 b14 一 b08 b07  b06  b05  b04  b03 b02 bQ1 


1 三 読み 込み 専用 

1 三 隠 し ファ イル 

1 ニシ ステ ム フ ァ イル 

1= ニ ボリ ュー ム 名 

1= ニ ディ レク トリ 名 

1= 通 常 の ファ イル 
(アー カイ ブ ) 

ー 1== 指 定 の ファ イル が ある か どう か チェ ッ ク し な いで 新規 作成 し ます 。 
Human68k ver.3.0 以 後 サ ポー ト さ れ た も の で 、dirsch 三 on 状態 を より 高速 化 
し た い 場 合 に 使用 し て くだ さい 。 た だ し 、 存 在 す る ファ イル を 指定 し た 場 
合 は 2 個 存 在 す る こと に な る の で 、 ご 注意 くだ さい 。 フ ァイル が 正常 に 作 
成 で きた ら 、 リ ター ン 値 (DOL) に 作成 し た ファ イル の ファ イル ハン ドル 
を 返し ます 。 ま た 、 負 の 数 な ら エ ラー コー ド で す 。 
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close 機能 拡 天 


で close(FILENO) DOS コ ー ル 番号 : $FF3E 

ファ イル を クロ ー ズ し ます 。 

FILENOG) word ファ イル ハン ドル 
MOVE.W FILENO, 一 (SP) 


DC.W _CLOSE 
ADDQOL  #2.SP 


リ ター ン | DOL 
DOL く 0… エ ラー コー ド 


解 FILENO で 指定 し た ファ イル ハン ドル を クロ ー ズ し ます 。 


Human68k ver.3.0 以 後 は dup し た ハン ドラ を クロ ー ズ し て も 標準 プロ ッ ク デ バ 
イス に 対し て は ファ イル 長 や 更新 日 時 の 書き 込み を 行い ます 。 
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4. 1 拡張 DOS コ ー ル 


ee 


@files(FILBUF,NAMEPTR,ATR) DOS コー ル 番 号 : $FF4E 
ファ イル を 検索 し 、 フ ァイル 情報 を 得 ま す (最初 の ファ イル ) 。 


引 数 | FILBUF(w) address バッ ファ (ファ イル 情報 ) へ の ポイ ンタ 
NAMEPTR(Y) address 文字 列 (ファ イル 名 ) へ の ポイ ンタ 
ATRG) word 属性 モー ド 

MOVE.W ATR, 一 (SP) 

PEA NAMEPTR 
PEA FILBUF 
DC.W _FILES 
LEA 10(SP),SP 

NAMEPTR:DC.B '※*.DOC'0 

ト ] 

FILBUF: DC.B ATR 玉 
DC.B DRIVENO 玉 
DC.W DIRCLS 
DC.W DIRFAT | Human68k 内 部 で 使用 
DC.W DIRSEC * | 壊す と NFILES で き な く な る 
DC.W DIRPOS 玉 
DC.B FILENAME(8) * 
DC.B EXT(3) 玉 
DS.B 1 * ま アトリビュート の 一 致 
DS.W 1 ※ ま ファ イル の 変更 最終 時 刻 
DS.W 1 ※* フ ァイル の 変更 最終 月 日 
DSL 1 ネ ※* ネ ファ イル サイ ズ 
DS.B 23 ネフ ァイル 名 ( 主 フ ァイル 名 十 "" 十 

拡張 子 十 0) 
* 計 5S3 バ イト 


FILBUF の 最上 位 ビ ッ ト を オン に する と FILBUF が 以下 の 拡張 形式 で ある こと 
を 表し ます 。 な お この 機能 は Human68k ver.3.0 以 後 で サポー ト さ れ て いま す 。 


FILBUF: DC.B ATR * 
DC.B DRIVENO 玉 
DC.W DIRCLS 玉 
DC.W DIRFAT * | Human68k 内 部 で 使用 
DC.W DIRSEC * | 壊す と NFILES で き な く な る 
DC.W DIRPOS 1 
DC.B FILENAME(8) キネ 
DC.B EXT3⑬) * 


201 


第 4 章 


リ ター 


202 


追加 DOS プ IOCS コ ー ル 


きゃ 


ピコ 


DS.B 
DS.W 
DS.W 
DS.L 
DS.B 


DS.B 


DO0L 


1 * ネ アト リ ビ ュ ー ト の 一 致 

1 * フ ァイル の 変更 最終 時 刻 

1 * フ ァイル の 変更 最終 月 日 

1 * ネ ファ イル サイ ズ 

23 まま ファ イル 名 ( 主 フ ァイル 名 十 "' 十 
拡張 子 十 0) 

B:' ネネ ドラ イブ 名 

\TEST\'.0 * デ ィ レ クト リ 名 

65 一 7 ネ 

'ABCDEFGH' *ー Human68k 内 部 で 使用 

7 * | 壊す と NFILES で き な く な る 


本 KLMN'.0.0.0.0 * 
* 計 141 バ イト (353 十 88) 


DOL く 0… エ ラー コード 


ATR で 指定 し た 属性 に あて は まる ファ イル (NAMEPTR で 指定 ) を サー チレ し 
て 、 そ の ファ イル 属性 を FILBUF で 指定 し た バッ ファ に 書き 込み ます 。 


NAMEPTR に は 、 ワ イル ドカ ー ド が 使用 で きま す 。 
ATR の 各 ビ ッ ト は 次 の 通り で す 。 2 つ 以 上 の ビッ ト を セッ ト し た 場合 に は 、 
その ビッ ト の いずれ か を 検索 し た ら 終 了 し ます 。 


b15 b14 一 b07 b06  b05 b04  b03 b02 bO1 b00 


1 読み 込み 専用 

1= ニ 隠し ファ イル 

1 シス テム ラ ア イル 

1= ニ ボリ ュー ム 名 

1= ニ ディ レク トリ 名 

1= 通 常 の ファ イル 
(アー カイ ブ ) 


| 1 ニーa: で a: 玉 .※ を 、test で test を 検索 する モー ド 


また FILBUF の 最上 位 ビ ッ ト を オン に する と 、 拡 張 FILBUF 形 式 で files を 行う こ 
と を 意味 し ます 。 な お この 機能 は 、Human68k ver.3.0 以 後 で す ポ ー ト され て い 


ます 。 


4. 1 拡張 DOS コ ー ル 


nfiles 昌 


@nfiles(FILBUF) DOS コー ル 番 号 : $FF4F 


次 の ファ イル を 検索 し 、 フ ァイル 情報 を 得 ます 。 


引 数 | FILBUF(w) address バッ ファ (ファ イル 情報 ) へ の ポイ ンタ 


PEA FILBUF 
DC.W _NFILES 
ADDQL  #4.SP 
来 
FILBUF: DC.B ATR 玉 
DC.B DRIVENO 玉 
DC.W DIRCLS 玉 
DC.W DIRFAT ** | Human68k 内 部 で 使用 
DC.W DIRSEC ** | 壊す と NFILES で き な く な る 
DC.W DIRPOS 玉 
DC.B FILENAME(8) キ * 
DC.B EXT(3) 玉 
DS.B 1 ネネ アト リ ビ ュ ー ト の 一 致 
DS.W 1 ネフ ァイル の 変更 最終 時 刻 
DS.W ) ネフ ァイル の 変更 最終 月 日 
DSL 1 ネフ ァイル サイ ズ 
DS.B 23 まま フ ァイル 名 ( 主 フ ァイル 名 十 "' 十 
拡張 子 十 0) 
* 計 53 バ イト 


FILBUF の 最上 位 ビ ッ ト を オン に する と FILBUF が 以下 の 拡張 形式 で ある こと 
を 表し ます 。 な お この 機能 は Human68k ver.3.0 以 後 で サポ ー ト され て いま す 。 


FILBUF: DC.B ATR * 
DC.B DRIVENO 玉 
DC.W DIRCLS 玉 
DC.W DIRFAT 玉 | Human68k 内 部 で 使用 
DC.W DIRSEC 玉 | 壊す と NFILES で き な く な る 
DC.W DIRPOS * 
DC.B FILENAME(8) * 
DC.B EXT(3) 玉 
DS.B 1 ま ア トリビュー ト の 一 致 
DS.W 1 ネフ ァイル の 変更 最終 時 刻 
DS.W 1 ネフ ァイル の 変更 最終 月 日 
DSL 1 率 フ ァイル サイ ズ 
DS.B 23 ネフ ァイル 名 ( 主 フ ァイル 名 十 "" 十 
拡張 子 十 0) 
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DC.B TB:' ※ ま ドラ イブ 名 

DC.B \TESTY'0 まま ディ レク トリ 名 

DS.B 65 一 7 玉 

DC.B 'ABCDEFGH' *ー Human68k 内 部 で 使用 

DC.B 、 則 * | 時 NLES で き な く な る 


DC.B TKLMNT'.0.0.0.0 * 
* 計 141 バ イト ($3 十 88) 


por 


DO 上 L く 0… エ ラー コー ド 


files で 求め た FILBUF を 使っ て 、 次 の ファ イル を 検索 し 、 そ の ファ イル 情報 を 
再度 FILBUF に 書き 込み ます 。 
また files で FILBUF の 最上 位 ビ ッ ト を オン に し て いた 場合 は 、 拡 張 FILBUF 形 式 
で nfiles を 行う こと を 意味 し ます 。 
な お この 機能 は 、Human68k ver.3.0 以 後 で す ポ ー ト され て いま す 。 
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4. 1 拡張 DOS コ ー ル 


FuSh_Se キ ーー ーー possz 


@fflush_set(FLG) DOS コール 番号 : $FF7A,$FFAA 
finsh コ ー ル の 有効 ・ 無 効 を 制御 し ます 。 


引 数 | ELe word フラ グ 


MOVE.W  #0, 一 (SP) 
DCW _FFLUSH_SET 
ADDOL  #2.SP 
31 23 !) 7 0 


リ ター ン | DOL 前 の フラ グ 内 容 (FLG が 1 の 場合 は 現在 の フラ グ 内 容 ) 。 


ffiunsh コ ー ル の 有効 ・ 無 効 を 制御 し ます 。 
プロ グラ ム 内 で ffush を 使用 し て 、 頻 筐 に バッ ファ か ら フ ラッ シュ し て いる と 
き 、FASTIO,FASTOPEN,FASTSEEK な どの 外部 コマ ンド を 常 及 し て いて も 、 
高速 化 が あま り 有 効 で な い 場 合 が あり ます 。 
この よう な 場合 は 、 こ の コー ル で ffush を 無効 に し て お く こ と に より 、 高 速 化 
を 有効 に する こと が で きま す 。 た だ し 、fflush を 実行 し な いこ と は 危険 で す の 
で 、 通 常 の 使用 で は 有効 に し て お いて くだ さい 。 


FLG の 値 に より 、 以 下 の 意味 を も ち ま す 。 
0……ffush を 実行 し て も 、 何 も 実行 し た いで も どり ます 。(ffiush 三 OffD) 
1……: 代 ush を 実行 する と 、 キ ー の 先読み フラ ッシュ と 、 キ ャ ッシュ バッ 
ファ の 書き 出し お よび 、 フ ラッ シュ を 行い ます 。 (ffiush 三 On) 
ー1… 現 在 の フラ グ 値 (0 もしくは 1 ) を DOL に 返し ます 。 


な お この 機能 は 、Human68k ver.3.0 以 後 で す サポ ー ト され て いま す 。 
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oS_patch (シス テム 専用 コー ル ) 新規 DOS コ ー ル 


@os patch(PATCH_NO,PATCH_ADR) DOS コ ー ル 番号 : $FF7B, $FFAB 


Human68k ver.3.0 で サポ ー ト され た 外部 コマ ンド の FASTIO、FASTOPEN、 
FASTSEEK を Human68k に 登録 し た り 、 制 御 し た りす る コー ル で す 。 


引 数 | PATCHNOG word パッ チ 機 能 番号 
PATCH_ADR(r) address パッ チ プ ログ ラム へ の ポイ ンタ 
PEA PATCH_JOB 
MOVE.W  #PATCH_NO, 一 (SP) 
DC.W _OS_PATCH 


ADDOL  #6,SP 


PATCH_JOB: 


31 23 15 / 0 


PATCH_NO 


PATCH_ADR 


リ タ ー ン | DOL 前 の 処理 アド レス (PATCH_ADR が 0 の 場合 は エラ ー コ ー ド ) 。 


Human68k の 内 部 処理 を 取り 替え ます 。 


パッ チ す る 機能 番号 と その 処理 アド レス を 指定 する こと に より 、 指 定 の 処理 
に 変更 で きま す 。 パ ッ チ 機能 番号 は 以下 の 通り で す 。 

1 三 FASTIO 用 

2 ニ FASTSEEK 用 

3 三 FASTOPEN 用 
PATCH_ADR に 0 を 指定 する か 、PATCH_NO の 上 位 8 ビッ ト に 0 以外 を 指定 
する こと に より 、 そ の パッ チ 処 理 の 最初 の エン トリ ー (常駐 解除 ) を 呼び 出 
すこ と が で きま す 。PATCH_NO の 上 位 8 ビッ ト を D1.W の 上 位 8 ビッ ト に 、 
PATCH_ADR を D2 し に 保存 し て コー ル さ れ ま す の で 、 常 駐 解除 以外 の 常駐 部 
と の イン ター フェ イス と し て 使用 する こと が で きま す 。 
PATCH_ADR に 一 1 を 指定 する こと に より 、 そ の パッ チ 処 理 の 2 ・3 番 目 の 
エン トリ ー (クロ ー ズ 及び 初期 化 ) を 呼び 出し 、 常 駐 中 の プロ グラ ム の 初期 
化 が で きま す 。 
本 コー ル の 利用 に あたっ て は 、 シ ステ ム 内 部 の 詳細 な 知識 が 必要 な た め 、 シ 
ステ ム 専 用 の コー ル と し ます 。 
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4. 1 拡張 DOS コ ー ル 


SS 


@get_fcb_adr(FILENO) DOS コ ー ル 番号 : $FF7C,$FFAC 
指定 の ファ イル ハン ドル が 使用 し て いる FCB の 先頭 アド レス を 得 ます 。 


引 数 | EiLENOr) word ハン ドラ 番号 


MOVE.W FILENO,-(SP) 
DCW _GETFCB_ADR 
ADDQL  #2.SP 
31 23 0 


リ タタ ーー ン | DOL 内 部 FCB ア ドレ ス 


DOLS Os エラー コー ドド 


解 説 | 指定 の ファ イル ハン ドル が 使用 し て いる FCB の 先頭 アド レス を 得 ま す 。 
ハン ドラ 番号 か ら 内 部 で 使用 中 の FCB の アド レス を 得 ま す 。 あ くま で も 内 部 
の FCB で すか ら 不 用 意 に 書き 替え な いで くだ さい 。 オ ー プ ン 中 の ファ イル の 
名 前 を 調べ る と き な ど に 、 ご 利用 くだ さい 。 
また 、 こ の アド レス は スー パー バイ ザー 領域 の た め 、 通 常 の アク セス で は バ 
克 琴 ジー と な り ま す 。 


な お この 機能 は 、Human68k ver.3.0 以 後 で サポ ー ト され て いま す 。 
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FbreakCKーーーー 


@breakck(FLG) "DOS コ ー ル 番号 : $FF33 
プレ ー ク チェ ッ ク を 設定 し ます 。 


FLG) word フッ ラグ 


MOVE.W FLG,. 一 (SP) 
DCW _BREAKCK 
ADDQL  #2.SP 
31 23 15 7/ 0 


リ ター ン | DOL 設定 状況 (FLG = 1 の と き ) 
DO エニ 0…… 指定 の DOS コ ー ル の み チ ェ ッ ク 
DOL =1…… すべ て の DOS コ ー ル で チェ ッ ク 
DO0L = 2 …… すべ て の DOS コ ー ル で チェ ッ ク し な い 


プレ ー ク チェ ッ ク を 設定 し ます 。 
次 に 示す よう に 、FLG の 値 に よっ て どの よう に チェ ッ ク す る か を 選択 し ま 
す 。 
FLG = 0…… 指 定 の DOS コ ー ル だ け チ ェ ッ ク す る 
IIG 1 の … すべ て の DOS コ ー ル を チェ ッ ク す る 
FLG 2 …… すべ て の DOS コ ー ル で チェ ッ ク し な い 
FLG = ー1 …… 設 定 状況 を 調べ る 


[指定 の DOS コ ー ル | と は 、「 プ レー クチ ェ ッ ク を し ます 」 と 書か れ た 以下 
の DOS コ ー ル の こと で す 。 

getchar($FFO1) print(($FFO09) 

putchar($FFO02) gets($FFOA) 

cominp($FFO3) keysns($FFOB) 

comout($FFO4) kflush($FFOC) 

prnout($FFOS) fputc($FFOD) 

getc($FFO8) fputs($FFOE) 


これ ら の 機能 に 加え て 、Human68k ver.3.0 以 後 で は 、 以 下 の 設 定 が 可能 で す 。 
これ は 、CTRLC,P.N.Q.S の 各 機 能 を ON/OFF す る た め の も の で 、OFF に する 
と その コー ド は 通常 の キー 入力 で 読め る よう に な り ま す 。 Human68k の バー 
ジョ ン を チェ ッ ク し て か ら 使 用 し て くだ さい 。 


208 


POT 


4. 1 拡張 DOS コ ー ル 


CTRL 十 C お よび BREAK の 内 部 処理 が ON(1) か 
OFF(0) か を 調べ る 。 

CTRL 十 上 お よび BREAK の 内 部 処理 を する モー ド 
に 変更 する 。 

CTRL 十 C お よび BREAK の 内 部 処理 を し な いで 
コー ド を 返す モー ド に 変更 する 。 


CTRL 十 N の 処理 が ON(1) か OFF(0) か を 調べ る 。 
CTRL 十 N の 内 部 処理 を する モー ド に 変更 する 。 
CTRL 十 N の 内 部 処理 を し な いで コー ド を 返す モー 
ド に 変更 する 。 


CTRL 十 P の 処理 が ON(1) か OFF(0) か を 調べ る 。 
CTRL 十 P の 内 部 処理 を する モー ド に 変更 する 。 
CTRL 十 P の 内 部 処理 を し な いで コー ド を 返す モー 
ド に 変更 する 。 


CTRL 十 0Q の 処理 が ON(1) か OFF(0) か を 調べ る 。 
CTRL 十 OQ の 内 部 処理 を する モー ド に 変更 する 。 
CTRL 十 Q の 内 部 処理 を し な いで コー ド を 返す モー 
ド に 変更 する 。 


CTRL 十 S お よび SHIFT 十 BREAK の 処理 が ON(1) か 
OFF(O) か を 調べ る 。 

CTRL 十 S お よび SHIFT 十 BREAK の 内 部 処理 を する 
モー ド に 変更 する 。 

CTRL 十 S お よび SHIFT 十 BREAK の 内 部 処理 を し な 
いで コー ド を 返す モー ド に 変更 する 。 
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IOcTrl ーー 


@iocir(MD[FILENO] [DRIVE] [COUNT,TIME] [DTI[PTR,LEN][F_CODE,PTR1) 


DOS コ ー ル 番号 : $FF44 


デバ イス ドラ イ バ の IOCTRL に より ダイ レク ト に 入出 力 し ます 。 


引 数 
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MDr) word 
FILENO(Gr) word 
DT) word 


DRIVE(r) word 


コン トロ ー ル モー ド ( こ の 値 に よっ て 引数 が 異な り ま す ) 
ファ イル ハン ドル 

装置 情報 

装置 情報 


PTR(r) address ポイ ンタ 


LEN(r) long 

COUNT) word 
TIMEr) word 
F_CODE(r) word 


書き 込み バイ ト 数 
リト ライ 回 数 

時 間 

ファ ンク ショ ン 番 号 


く MD = 0.6.7.9.10> 
MOVEL 
MOVE.W 
DC.W 
ADDOQL 

31 23 


FILENO, 一 (SP) * ま た は MOVE.W DRIVE, 一 (SP) 
MD, 一 (SP) 


_IOCTRL 


#4, 一 (SP) 


ED 三 ミ 1 ラウ 
MOVE.W 
MOVE.W 
MOVE.W 
DC.W 
ADDOQL 


DT, 一 (SP) * ま た は MOVE.W TIME, 一 (SP) 
FILENO, 一 (SP)  * MOVE.W COUNT, 一 (SP) 
MD, 一 (⑤P) 
_IOCTRL 
#6, 一 (SP) 
15 7 9 


4. 1 拡張 DOS コ ー ル 


ぐ MD = 2.3.4.5> 
MOVE.L LEN, 一 (SP) 
PEA PTR 
MOVE.W FILENO, 一 (SP) * ま た は MOVE.W DRIVE, 一 (SP) 
MOVE.W MD, 一 (SP) 
DC.W _IOCTRL 
LEA 12(SP),SP 


PTR: DS.B 2299 ※\222 は 読み 書き バイ ト 数 


31 23 15 7 0 
FILENO (DRIVE) 2 (SP) 


ぐ MD 12,13 > 
PEA PITR 


MOVE.W  F CODE, 一 (⑤P) 

MOVE.W FILENO, 一 (SP) * ま た は MOVE.W DRIVE, 一 (SP) 
MOVE.W MD, 一 (SP) 

DC.W _IOCTRL 

LEA 10(SP),SP 


PTR: DS.B 72922 *227 は デバ イス ドラ イ バ に よる 


31 23 15 が 0 
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リ ター ン | く MD=01> 
DOL 装置 情報 


ぐ MD = 2 一 5> 
DOL 実際 に 読み 書き し た バイ ト 数 


ぐ MD ニ 6,7,.9,.10> 
DO スズ デー クス 


ぐ MD = 11.12,13 > 
デパ イス ドライバ パ に より ます 。 


デバ イス ドラ イ バ の ダイ レク ト 入 出力 を し ます 。 


MD に より 次 の それ ぞ れ の 意味 を も ち ま す 。 

MD = 0 ioctrl(0.FILENO) 
FILENO で 指定 し た ハン ドル の 装置 情報 を 、DOL に 返し ます 。 

MD = 1 iocrl(1.FILENO,DT) 
FILENO で 指定 し た ハン ドル に 、 装 置 除法 を 設定 し ます 。 
DO 上 L に は 、 前 の 装置 情報 を 返し ます 。 

MD = 2 iocri(2.FILENO,PTR LEN) 
FILENO で 指定 し た ハン ドル か ら 、PTR に LEN バ イト 読み 込み ま 
Wi 
DO 上 に は 、 読 み 込み バイ ト 数 を 返し ます 。 

MD = 3 iocrl(3.FILENO,PTR LEN) 
FILENO で 指定 し た ハン ドル に 、PTR か ら LEN バ イト 書き 込み ま 
す 。 
DO.L に は 、 書 き 込 み バ イト 数 を 返し ます 。 

MD = 4 iocrl(4.DRIVE,PTR,LEN) 
DRIVE で 指定 し た 装置 番号 (0 ニカ レン ト 、1= A:) か ら 、PTR 
に LEN バ イト 読み 込み ます 。 
DO し に は 、 読 み 込 み バ イト 数 を 返し ます 。 

MD = $ jocrl($,DRIVE,PTR,LEN) 
DRIVE で 指定 し た 装置 番号 (0= ニ カレ ント 、1=A:) か ら 、PTR 
に LEN バ イト 書き 込み ます 。 
DOL に は 、 書 き 込 み バ イト 数 を 返し ます 。 

MD = 6 ioctrl(6.FILENO) 
FILENO で 指定 し た ハン ドル の 入力 ステ ー タ ス を 、DO0 エ に 返し ま 
すず 。 
内 容 は 次 の 通り で す 。 
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MD = 7 iocrl(7FILENO) 
FILENO で 指定 し た ハン ドル の 出力 ステ ー タ ス を 、D0L に 返し ま 
す 。 
内 容 は 次 の 通り で す 。 


MD = 9 iocrl(9,DRIVE) 
DRIVE で 指定 する ドラ イブ プ が 、 ロ ー カ ル か リモ ー ト か を 、DOL 
選 返 し ます 。 
内 容 は 次 の 通り で す 。 
DO0L…… ロ ー カ ル な ら ド ライ ブ 情 報 
DO0L…… リ モー ト な ら ビ ッ ト 12 が 1 


MD 10ioctrl(10.FILENO) 
FILENO で 指定 し た ドラ イプ が 、 ロ ー カ ル か リモ ー ト か を 、DOL 
選 返 し ます 。 
内 容 は 次 の 通り で す 。 
DO0L…… ロ ー カ ル な ら ド ライ ブ 番 号 
DO0L…… リ モー ト な ら ビ ッ ト 12 が 1 


MD = 11ioctrl(11.COUNT,TIME) 
リト ライ 数 を 設定 し ます 。 デ フォ ルト の 値 は 3 回 で 、 時 間 は 100 
秒 で す 。 
この 関数 は デバ イス ドラ イ バ で サポ ー ト され ます 。 

MD = 12ioctrl(12.FILENOJF_CODEPTR) 
ハン ドル に よる 特殊 コン トロ ー ル を 行い ます 。 

MD = 13ioctrl(13.DRIVE,F_ CODE,PTR) 
ドラ イブ に よる 特殊 コン トロ ー ル を 行い ます 。 
Human68kver.3.0 以 降 で は 、 2HD タ イプ 以外 の FD に 対応 する た め 
に 、 以 下 の よ うに 拡張 され て いま す 。 
F_CODE=ー1 の 場合 、 PTRL に "DISKdev1' の 8 文字 を 返し ます 。 
F_CODE=0 の 場合 、PTRL の 先頭 1 ワー ド に media id を 返し ま 
す 。 
F_CODE=1 の 場合 、PTRIL に は 以下 の 情報 を 返し ます 。 


PTR: DCL trap15 の リタ ー ン 値 (DO の 値 * エ ラー ビッ ト ) 
DC.W 1024 * 1 セク タバ イト 数 
DC.B 1 * ま FAT 内 セク タ 数 
DCB 2  *FAT 数 
DC.W 1 * 予 約 セ クタ 
DC.W 192 * ル ー ト ディ レク トリ エン トリ 数 
DC.W 8 キネ 77*2 玉 総 セク タ 数 
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214 


DC.B $FE *mediaid 

DC.B 2 **FAT エ リア セク タ 数 

DC.W 8 * ま ヘッ ダ 内 セク タ 数 

DC.W 2 * ト ラック 内 ヘッ ダ 数 

DC.B $90 *BIOS 制 御 D1.high パ ラメ ー タ 

DC.B 一 | ※ ま イジ ェクト フラ グ ワ ー ク エリ ア ( メ 
ディ アチェ ッ ク の た め ) 


F_CODE=2 の 場合 、PTR は バッ ファ の アド レス で は な く て 、 以 
下 の 値 を 指定 し ます 。 上記 PTR の 最後 の 1 バイ ト の 値 を 変更 する 
機能 で す 。 


PTR.L ニ ー1… イ ジェ クト され た 物 と し て BPB と DPB を 再 構築 し 
な さい 。 

PTRL 三 0……BIOS フ ァ ン クシ ョ ン の $4E の 返す 値 に 従い な さい 
(通常 ) 。 

PTR.L し 1…… イ ジェ クト され て いな い 物 と し て 、 メ ディ ア 
チェ ッ ク (media check) を 1 回 無視 し な さい 


※ デ バイ ス ド ラ イ バ の デバ イス ヘッ ダ の IOCTRL ビ ッ ト が 0 の 場合 は 、 入 出力 
で きま せん 。 


装置 の 情報 の 値 は 、 次 の よう な 意味 を も っ て いま す 。 


ビッ ト 意 味 
| ? 標準 入力 
1 標準 出力 
由 NULL 
3 CLOCK 
4 (予備 ) 
5 0 …COOKED 
1 …RAW 
6 (予備 ) 
7 0 … ド ライ ブ 
1 … デ バイ ス 
な 11 (予備 ) 
12 0 … ロ ー カ ル 
1 ・・ リ モー ト 
13 0 … 通 常 の プロ ッ ク デ バイ ス 
1 … 特 殊 プ ロッ ク デ バイ ス 
14 0 …IOCTRL 不 可 
1 …IOCTRL 可 


4. 1 拡張 DOS コ ー ル 


malloc2 ee 


DOS コ ー ル 番号 : $FF58,$FF88 
メ モリ を 指定 され た 方 法 で 確保 し ます 。 


@malloc2(MD,LEN [,PTR] ) 


MDG) word コン トロ ー ル モー ド 
LEN(r) long バイ ト 数 
PTR(r) address 
<vp =0i2> 
MOVE.L LEN, 一 (SP) 
MOVE.W MD,(SP) 
DC.W _MALLOC2 
ADDOL  #6SP 
31 23 15 7 0 
LEN 2 (SP) 
ぐ IMD = $8000,$8001,$8002> 
PEA PTIR 
MOVE.L LEN, 一 (SP) 
MOVE.W MD, 一 (SP) 
DC.W _MALLOC2 
LEA 10(SP),SP 
PTRR: 
31 23 15 7 0 
LEN 2 (SP) 
6 (SP) 
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LEN で 指定 し た バイ ト 数 の メモ リ を 確保 し て 、 そ の ポイ ンタ を 返し ます 。 
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LEN は 、 下 位 24 ビ ッ ト の み 有 効 で す 。 
MD に は 、 メ モリ を 確保 する 方 法 を 決定 する モー ド を 指定 し ます 。 

MD = 0…… 下位 か ら 探し 、 割 り 当 て る 。 

MD = 1 …… 必要 最小 プロ ッ ク か ら 割 り 当 て る 。 

MD = 2・…… 上 位 か ら 探し 、 割 り 当 て る 。 
さら に Human68k ver.3.0 以 降 で は 、MD が 以下 の 値 の と き 、 親 の メモ リ 管 理 ポ 
イン タ の 先頭 PTR を 指定 する こと で 、 常 久 プ ログ ラム や デバ イス ドラ イ バ か ら 
の メモ リ 確 保 が 可能 と な り ま し た 。 

MD = $8000 …… 下位 か ら 探 し 、 割 り 当 て る 。 

MD = $8001 …… 必 要 最 小 プ ロッ ク か ら 割 り 当 て る 。 

MD = $8002 …… 上 位 か ら 探 し 、 割 り 当 て る 。 


リタ ー ン の DO 上 L は 、 確 保 さ きれ た バイ ト 数 の メモ リプ ロック が 確保 で き な い 場 
合 は 、$81000000 十 最大 バイ ト 数 を 返し ます 。 
完全 に 確保 不能 の 場合 は 、$8200000? を 返し ます 。 


4. 1 拡張 DOS コ ー ル 


S malloc EE 


で Ss malloc(MD,LEN [,PTR] ) DOS コ ー ル 番号 : $FF7D,$FFAD 


メイ ン の メモ リ 管 理 下 か ら メ モリ プロ ッ ク を 確保 し ます 。 
MDG) word コン トロ ー ル モー ド 


LENr) long バイ ト 数 
PTR(r) address 


く MD = 0.12> 


MOVEL LEN, 一 (SP) 
MOVE.W MD, 一 (SP) 


DC.W _S_MALLOC 
ADDO.L #6,SP 
0 23 15 記 0 
LEN 2 (SP) 


ぐ MD  $8000,$8001,$8002> 
PEA PTIR 
MOVEL LEN, 一 (SP) 
MOVE.W _ MD, 一 (SP) 
DC.W _MALLOC2 
ADDOQL  #10,SP 


DO エ = $82000007…… 完 全 に 確保 不能 (? は 不定 ) 
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解 語 LEN で 指定 し た バイ ト 数 の メモ リ を 、 メ イン の メモ リ 管 理 下 か ら 確 保 し 、 そ 

の ポイ ンタ を 返し ます 。 
LEN は 、 下 位 24 ビ ッ ト の み 有 効 で す 。 
MD に は 、 メ モリ を 確保 する 方 法 を 決定 する モー ド を 指定 し ます 。 

MD = 0 …… 下 位 か ら 探 し 、 割 り 当 て る 。 

MD = 1 …… 必 要 最 小 ブ ロッ ク か ら 割 り 当 て る 。 

MD = 2 …… 上 位 か ら 探 し 、 割 り 当 て る 。 
さら に Human68kver.3.0 以 降 で は 、 MD が 以下 の 値 の と き 、 親 の メモ リ 管 理 ポ 
イン タ の 先頭 PTR を 指定 する こと で 、 常 駐 プ ログ ラム や デバ イス ドライバ か ら 
の メモ リ 確 保 が で きる よう に な り ま し た 。 

MD = $8000 …… 下 位 か ら 探し 、 割 り 当 て る 。 

MD = $8001 …… 必 要 最 小 プ ロッ ク か ら 割 り 当 て る 。 

MD 三 $8002 …… 上 位 か ら 探し 、 割 り 当 て る 。 


リタ ー ン の DO 上 は 、 確 保 レ し た メモ リプ ロッ ク の ポイ ンタ (メモ リ 管 理 ポ イン 
タ は 一 $10) を 返し ます 。 

指定 され た バイ ト 数 の メモ リプ ロッ ク が 確保 で き な い 場合 は 、$81000000 十 最 
大 バイ ト 数 を 返し ます 。 

完全 に 確保 不能 の 場合 は 、$8200000? を 返し ます 。 

s malloc は 、 通 常 の アプ リケーション プロ グラ ム で は 使用 し て は いけ ませ ん 。 
s_malloc を 使用 する プロ グラ ム は 、OS か ら 起 動き れ て 、 終 了 す る こと が で き 
な い (常駐 プロ セス の よう に exit や exit2 の DOS コ ー ル を 行わ な い ) プロ グラ ム 
で な けれ ば な り ま せん 。 
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3 


2 


EN 


拡張 |)OCS コ ー ル 


と こと で は 、X68030 も し く は IOCSX で 新規 に 追加 され た IOCS コ ー ル を 説明 し て いま す 。 


な お 、IOCS 双 の 詳細 に つい て は 「 プ ログ ラマ ー ズ マニ ュ ア ル 」| の | 付録 7 


を 


参照 し て くだ さい 。 


また 、X68030 で は IOCS メ を 組み 込む 必要 は あり ませ ん 。 


介 ライ ブラ リー 覧 (アル ファ ベッ ト 順 ) 


IOCS.X | 


ト 


名 前 | 機 能 軸 
B_CONMOD カー ソル お よび スク ロー ル の コン トロ ー ル 222 
B_CONSOL 表示 範囲 指定 221 
DRAWMODE グラ フィ ッ ク 描 画 の 指定 223 
SYS_STAT 各種 シス テム 状態 の 取得 設定 225 
TXLINE テキ スト 画面 の ライ ン 224 
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1 


代 B CONSOL IOCS コ ー ル 番号 : $2E 
表示 範囲 指定 
DOL $2E IOCS コ ー ル 番号 


D1L 表示 開始 ドッ ト 位 置 
D2L 表示 範囲 指定 


な し (DOL の 内 容 は 保証 され ませ ん ) 


ROM 版 IOCS で は 、 横 方 向 の 表示 開始 ドッ ト 位置 が 16 ド ッ ト 単 位 (16 の 倍数 ) 
で し た が 、8 ド ッ ト 単 位 (8 の 倍数 ) で 指定 で きる よう に な り ま し た 。 
た だ し 、8 ド ッ ト 単 位 の 指定 を ROM 版 IOCS で 行う と 、 ア ドレ スエ ラー が 出 ま 
す 。 
表示 領域 だ け ス クロ ー ル し た いと き は 、B_CONMOD($AD) の モー ド 18、 ソ フ 
トコ ピー スク ロー ル を 指定 し て くだ さい 。 
この コー ル を 実行 後 カ ー ソ ル は 、 ホ ー ム 位置 に 移動 し ます 。 
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B_CONMOD 


価 B CONMOD IOCS コ ー ル 番号 : $AD 
カー ソル お よび スク ロー ル の コン トロ ー ル 
DOL $AD IOCS コ ー ル 番号 


D1.L MODE カー ソル モー ド 
D2.L ADDRESS スク ロー ルモード 


リ ター ン | な し (DOL の 内 容 は 保証 され ま せん) 


解 説 | DI エ L で 指定 され た カー ソル (スク ロー ル ) の コン トロ ー ル を し ます 。 
D1L ーー 1 の te カー ソル の 点滅 を する (既定 値 ) 
D1L ニモ 2… の ee… カー ソル の 点滅 を 禁止 する 
D1L デー 3… の の … カー ソル の パタ ー ン を 指定 する 
レジ スタ D2L の 値 に より 、 動 作 が 次 の よう に な り ま す 。 
D2.L の 下位 ワー ド が 0 : 内 部 バッ ファ に 定義 さん た カー ソル パタ ー ン を カー 
ソル と し て 描画 し ます 。 (X68030 で は 無効 ) 
D2 エ の 下位 ワー ド が 0 以外 : 
下位 バイ ト を プレ ー ン 0、 上 位 バ イト を プレ ー ン 1 の 
排他 論理 (EXOR) の デー タ と し 、D2 の 上 位 ワ ー ド 
で 指定 さき れる スタ ー ト ライ ン か ら カ ー ソ ル を 描画 し 
ます 。 ス ター トラ イン は 0 一 15 で 指定 し ます 。D2L 
が $0000FFFF で あれ ば 、 今 まで の カー ソル と 同じ に 
な り ま すず 。 


D1.L ーー 4… の ir… D2.L で 示さ きれ る アド レス の カー ソル パタ ー ン デー タ を 内 部 
バッ ファ に コピ ー し ます 。 カ ー ソ ル パ タ ー ン は 、 最 初 の 16 バ 
イト が プレ ー ン 0、 次 の 16 バ イト が 、 プ レー ン 1 の パタ ー ン と 
な り ま す 。 (X68030 で は 無効 ) 


D1L ニ 16……… スム ー ス スク ロー ル の 指定 
D2 エ L = 0 の … の の oi ジャ ンプ スク ロー ル (既定 値 ) 
D2L ーー 1……… 4 ドッ トス クロ ー ル 
D2L ニ 2…0…t… 8 ドッ トス クロ ー ル 
D2L テ 3……… 16 ド ッ ト ス クロ ー ル 


スム ー ス スク ロー ル を 使う 場合 、 文 字 を 連続 的 に 出力 し な けれ ば 、 ス ク 
ロー ル の と き に 画面 が 乱れ ます 。 垂直 同期 (16ms) の 間 に 、1 ラ イン 出力 を 
J し て ぐだ さい 。 


DUE ビデ row ラス ター コピ ー ス クロ ー ル の 指定 (既定 値 ) 
DE 宮 wow ソフ トコ ピー スク ロー ル の 指定 


また 、 広 範囲 で の ソフ トス クロ ー ル は 、 表 示 速 度 が 遅 く な り ま す 。 
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| 


@DRAWMODE IOCS コ ー ル 番号 : $BO 


グラ フィ ッ ク 描 画 モ ー ド の 指定 


DO0L = $BO IOCS コ ー ル 番号 
D1.L = MODE 描画 モー ド 
D1L ま ー1 

DOL 前 の モー ド 
IT ニーi 


DOL 現在 の モー ド 


グラ フィ ッ ク 描 画 の 際 の 描画 モー ド を 変え ます 。 

D1L = 0… の の 通常 の モー ド 

D1L ーー 1 の ti 反転 の モー ド 

反転 モー ド で 描画 し た 場合 、 描 画す る グラ フィ ッ ク デ ー タ の 色 と 、 そ の デー タ 
が 描画 され る 場所 に あら か じ め 塗 られ て いる 人 色 の 否定 論理 (NOT) を 計算 し 、 
その 計算 結果 の 色 で グラ フィ ッ ク デ ー タ を 描画 し ます 。 ラ バー バン ド の ライ ン 
や 、 十 字 カ ー ソ ル な ど 、 一 時 的 に 画面 に ライ ン を 描画 し た いと き に 使い ます 。 
この モー ド に し て 描画 ルー チン を 2 回 呼ぶ と 、 画 面 デ ー タ が 元 に 戻り ます 。 
この 機能 を 使い 終え を た ら 、 必 ず 通 常 の 描画 モー ド に 戻し て くだ さい 。 
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TXLINE 


倫 TXLINE IOCS コ ー ル 番号 : $D5 
テキ スト 画面 の ライ ン 


DOL $D5 IOCS コ ー ル 番号 
A1L パラ メー タ の ポイ ンタ 
0(A1).W テキ スト プレ ー ン 番号 
2(A1).W 始点 X 座 標 
4(A1).W 始点 Y 座 標 
6(A1).W 終点 X 座 標 
8(A1).W 終点 Y 座 標 
10(A1).W ライ ンス タイ ル 


リ ター ン | な し (DOL の 内 容 は 保証 され ませ ん ) 


解 語 テキ スト 画面 の ライ ン 描 画 を 行い ます 。 
ライ ン と 重なっ た 文字 は 、 消 去 さ れ ま す 。 
入力 の A1L は 、 パ ラメ ー タ が 格納 され て いる アド レス の 先頭 で す 。 
入力 の 0(A1.W は 、 テ キス ト プ レ ー ン の 番号 (0 一 3) で す 。 
入力 の 2(A1).W、4(A1.W は 、 そ れ ぞ れ 始 点 の XX.Y 座 標 で す 。 
入力 の 6(A1).W、8(A1).W は 、 そ れ ぞ れ 終 点 の XX.Y 座 標 で す 。 
入力 の 10(A1.W は 、 ラ イン スタ イル で す 。 


注 意 CRTC (CRT コ ント ロー ラ ) の ビッ トマ スク 機能 を 使っ て いま す の で 、 マ ウス 
カー ソル は OFF に し て 、 こ の コー ル を 呼び 出し て くだ さい 。 
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SIMSHSIAI ニニ ニー うう の 


人 @SYS_STAT IOCS コ ー ル 番号 : $AC 
各種 シス テム 状態 の 取得 なら びに 設定 
DOL  $AC IOCS コ ー ル 番号 


D1L MODE モー ド 
D2.L CACHEBIT キャ ッシュ 有効 ・ 和 無効 フ プラグ (D1L 三 4 の と きのみ ) 


MODE ニ 0 の と き 


DO0L MPU ス テー タス 
ビッ ト 31 一 16 ニ クロ ックス ピー ド (MHz*10) 
ビッ ト 15 ー 0 : 浮 動 小 数 点 コ プロ セッ サ (FPCP) な し 
・ 浮動 小数 点 コ プロ セッ サ (FPCP) あり 
・ メ モリ マネ ー ジ ング ユニ ッ ト (MMU) な し 
・ メ モリ マネ ー ジ ング ユニ ッ ト (MMU) あり 
・ MPU が MC68000 
・ MPU が MC68010 
・ MPU が MC68020 
・ MPU が MC68030 


Co ト ら ーー OO テン の つの レー ご 


ビッツ ト 14 


ピトー 


MODE チチ 0 の と き 
DOL キャ ッシュ 有効 ・ 無 効 フ ラグ 
ビッ ト 1 三 0 : デ ー タ キャ ッシュ 無効 
1 : デ ー タ キャ ッシュ 有効 
ビッ ト 0 0 : 命 令 キ ャ ッシュ 無効 
1 : 命令 キャ ッシュ 有効 


MPU の 状態 取得 な ら び に キャ ッシュ の 状態 取得 ・ 設 定 を 行い ます 。 
MODE= ニ 0 の と き MPU の ステ ー タ ス を 取得 し ます 。 

MODE= ニ 1 の と き キ ャ ッシュ の 状態 を 取得 し ます 。 

MODE=2 の と き キ ャ ッシュ の 状態 を 初期 値 に 設定 し ます 。 
MODE= ニ 3 の と き キ ャ ッシュ を フラ ッシュ し ます 。 

MODE= ニ 4 の と き キ ャ ッシュ 設定 を 行い ます 。 


解 


に 
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OPMDRV 3 IOCS コ ー ル 


「C compiler PRO 一 68K ver2.1 NEW KIT] で は 、OPMDRV3.X に より FM 音源 プ MIDL/ 
ADPCM を 同時 に 制御 で きま す 。 

また 、 次 の よう に IOCS コ ー ル を 利用 し て アセ ンプ ラ か ら そ の 機能 を 利用 する こと も 可能 
で す 。 


moved.1 #OPM コ ー ル 番号 , D1 
moveq.1 #$FO, DO 
traD #15 


(OPMDRV3.X メ 用 の IOCS コ ー ル 番号 は 全て $FO で す 。) 


例 ) トラ ッ ク デ ー タ の 初期 化 


move.w #$01,D2 
moveq.1 #$00.D1 
moved.1 #$FO,DO 
fraD #15 


また は 、 マ クロ を 使用 し て 


include iocscall.mac 
move.W #1.D2 
moveq.1 # M_INIT 
IOCS _OPMDRV 


IOCS コ ー ル の 詳細 説明 は 、「 プ ログ ラマ ー ズ マニ ュ ア ル 第 3 章 IOCS コ ー ル | を 参照 し て 
くだ さい 。 
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4. 3 OPMDRV3 


@ ラ イブ ラリ 一覧 (アル ファ ベッ ト 順 ) 


IOCS コ ー ル 


名 前 機 能 県 
M_ALLOC 指定 トラ ッ ク の トラ ッ ク バ ッ フ ァ の 指定 230 
M_ANTOFF 指定 チャ ン ネ ル へ オー ルノー ト オ フ 出力 246 
M_ASSIGN 指定 チャ ン ネ ル の トラ ッ ク 指 定 231 
M _ATOI 指定 トラ ッ ク バ ッ フ ァ の 先頭 アド レス 取得 239 
M_BEND 指定 チャ ン ネ ル の ピッ チ ベ ン ド 設 定 268 
M _CHAN 出力 チャ ン ネ ル の 一 時 変更 240 
M _CONT 指定 チャ ン ネ ル の 演奏 再開 239 
M _CTPLERS 指定 チャ ン ネ ル へ 各種 の オフ 出力 263 
M _DIROUT MIDI の デー タ 出 力 246 
M_ENABLE 指定 チャ ン ネ ル の 発音 許可 247 
M_END 演奏 停止 小節 の 設定 237 
M _FREE 指定 トラ ッ ク バ ッ フ ァ の 残り バイ ト 数 の 取得 235 
M_FREEA ドラ イ バ 起 動 時 の トラ ッ ク バ ッ フ ァ 全 バイ ト 数 を 取得 | 234 
M _IFCHK MIDI イ ンター フェ イス の 有無 を 検出 254 
M _INIT トラ ッ ク バ ッ フ ァ の 初期 化 229 
M_MDREG MIDI 制 御 IC の レジ スタ に 値 を セッ ト 265 
M_MEAS 演奏 中 の 小節 番号 取得 255 
M_METER 曲 の 拍子 設定 250 
M_MOD 指定 チャ ン ネ ル の モジ ュ レ ーション 設定 269 
M_MODSNS FM 音源 の モジ ュ レ ーション の 深 さ 設定 258 
M_MSTVOL マス ター ボリ ュー ム の 設定 267 
M_M _STOP 指定 チャ ン ネ ル の 演奏 停止 238 
M_NTOFF 指定 チャ ン ネ ル ヘ ノート オ フ 出 力 248 
M_NTON 指定 チャ ン ネ ル ヘ へ ノート オン 出力 248 
M_OGMFLT MML 音 色 切 り 替 え コ マン ド の 出力 選択 272 
M_OPMEXC FM 音源 の パラ メー タ セ ッ ト の 選択 270 
M_OPMLEO FM 音源 の LFO の 発振 周波 数 の 設定 271 
M_OPMREG 指定 の OPM レ ジス タ に 値 を セッ ト 264 
M_OUT 1 バイ ト の デー タ を MIDI へ 出力 255 
M _PAN 指定 チャ ン ネ ル の パン ポッ ト 設 定 243 
M_PANFLT パン ポッ ト 設 定 コ マン ド の 出力 選択 274 
M _PCMBSY PCM の 実行 状態 を 返す 261 
M_PCMGET 登録 され て いる PCM デ ー タ の 取得 260 
M_PCMLEN 指定 の PCM デ ー タ の サイ ズ を 取得 260 
M_PCMON 指定 の PCM デ ー タ を 再生 262 
M_PCMREC 外部 入力 音 の PCM 録 音 259 
M_PCMSET 指定 の 音程 に PCM 音 を 登録 252 
M_PLAY 指定 チャ ン ネ ル の 演奏 開始 236 
M_PNMGET PCM 音 色 名 の 取得 267 
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名 
M_PNMSET 
M_PROG 
M_SNDSET 
M_START 
M_STAT 
M_SYNC 
M_SYSCH 
M_TEMPO 
M_TNMGET 
M_TNMSET 
M_TRK 
M_TRNS 
M_USE 
M_VEL 
M_VERSION 
M_VGET 
M_VOL 
M_VOLFLT 
M_VSET 
M_YCOM 


機 能 
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PCM 音 色 名 の 登録 
指定 チャ ン ネ ル の 音色 番号 設定 


SND フ ァイル 形式 の デー タ を FM 音源 用 に 登録 


演奏 開始 小節 の 設定 

指定 チャ ン ネ ル の 現在 の 演奏 状態 を 返す 
同期 モー ド 設 定 

チャ ン ネ ル 番 号 割 り 当 て 変更 

曲 の テン ポ を 指定 

FM 音源 の 音色 名 の 取得 

FM 音源 の 音色 名 の 登録 

指定 トラ ッ ク に MML デ ー タ を セッ ト 
指定 チャ ン ネ ル の 音程 シフ ト 

指定 トラ ッ ク バ ッ フ ァ の 使用 容量 の 取得 
指定 チャ ン ネ ル の ベロ シテ ィ を 設定 
OPMDRV3.X バ ー ジ ョ ン と 作成 日 付 の 取得 
FM 音源 の 音色 デー タ 取 得 

指定 チャ ン ネ ル の ボリ ュー ム 設 定 
MML ボ リュ ー ム コマ ンド の 出力 選択 
FM 音源 の 音色 を 設定 

Y コ マン ド の 解釈 


4. 3 OPMDRV3 IOCS コ ー ル 


NN 


@ OPM コ ー ル 番号 : $00 OPM コ マン ド : (In) 


トラ ッ ク バ ッ フ ァ の 初期 化 
DOL $FO IOCS コ ー ル 番号 


D1L $00 OPM コ ー ル 番号 
D2.W 初期 化 モ ー ド 


por = ラー コー ド 


DO0 上 =0…… 正 常 終了 


解 説 | 現在 の トラ ッ ク デ ー タ を 全て クリ ア し 、 各 トラ ッ ク バ ッ フ ァ を 4 バイ ト に 設 
刈 人 し 表す 。 
また 、 各 チャ ン ネ ル の パラ メー タ は 以下 の よう に 初期 化 さ れ ま す 。 


トラ ッ ク 番 号 ) ニチ ャ ン ネ ル 番 号 
音色 番号 三 1 

ボリ ュー ム 三 64 

パン ポッ ト ー 64 

ベロ シテ ィ ー 127 

トラ ンス ポー ズ =24 

拍子 =ー 4 ノ 4 

デン ボ 三 120 

同期 モー ド 内 部 同期 


入力 の D2.W は 、 音 色 デ ー タ の 初期 化 モ ー ド で す 。 

D2.W に 0 を 指定 し た 場合 は 、 音 色 デ ー タ を 初期 化 ぜ ず 、 1 の 場合 は 初期 化し 
ます 。 

リタ ー ン の D0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド | を 参照 し て くだ きい 。 
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追加 DOS プ IOCS コ ー ル 


M_ALLOC 


@ OPM コ ー ル 番号 : $01 OPM コ マン ド : (Mt$) 
指定 トラ ッ ク の トラ ッ ク バ ッ フ ァ の 設定 
DOL $FO IOCS コ ー ル 番号 
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D1L $01 OPM コ ー ル 番号 
D2L トラ ッ ク 番 号 X65536 二 バッ ファ サイ ズ 


DO0L エラ ー コ ー ド 
DO0L=0…… 正 常 終 了 


指定 の トラ ッ ク の バッ ファ サイ ズ を 設定 し ます 。 
全 ト ラッ ク バ ッ フ ァ 内 の デー タ は 、 ク リア され ます 。 
な お 、 総 トラ ッ ク の バッ ファ サイ ズ (それ ぞ れ の トラ ッ ク に 割り 当て られ て 
いる トラ ッ ク バ ッ フ ァ の 総合 計 ) は 、CONFIG.SYS フ ァイル 内 の OPMDRV3.X 
の 後に 指定 し て 、 再 度 シ ステ ム 起 動 す る こと に より 変更 で きま す 。 
DEVICE 王 \SYS\OPMDR V3.X #nnn 
(nnn : 総 ト ラ ッ ク バ ッ フ ァ サ イズ [単位 : KB] ) 
入力 の D2L は 、 上 位 16 ビ ッ ト が トラ ッ ク 番 号 (1 一 80) 、 下 位 16 ビ ッ ト が バッ 
ファ サイ ズ (4 一 65535 [単位 : バイ ト ] ) で す 。 
リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド 」 を 参照 し て くだ さい 。 


4. 3 OPMDRV3 IOCS コ ー ル 


aa 


人 @OPM コ ー ル 番号 : $02 OPM コ マン ド : (Ac11 


指定 チャ ン ネ ル の トラ ッ ク 指 定 


DO0L $FO IOCS コ ー ル 番号 
D1L $02 OPM コ ー ル 番号 
D2.L チャ ン ネ ル 番 号 X65536 十 トラック 番号 


DOL エラ ー コ ー ド 
DO 上 =0…… 正 常 終了 


指定 の チャ ン ネ ル で 使用 する トラ ッ ク を 設定 し ます 。 

覆 数 の チャ ン ネ ル に 同一 の トラ ッ ク を 割り あて る と 、 そ れ ぞ れ 同 じ 楽 譜 デ ー 
タ を 演奏 し ます 。 

また 、 複 数 の トラ ッ ク を 1 つの チャ ン ネ ル に 割り あて る と 、 最 も 新しく 割り 
ふら れ た トラ ッ ク の 楽譜 デー タ を 演奏 し ます 。 

デフ ォ ル ト 値 は せ 、 チ ャ ン ネ ル 1 一 2S が 、 そ れ ぞ れ ト ラッ ク 1 25 に 対応 しま 
1 

入力 の D2L は 、 上 位 16 ビ ッ ト が チャ ン ネ ル 番 号 (1 一 25) 、 下 位 16 ビ ッ ト が ト 
ラッ ク 番 号 (1 一 80) で す 。 

リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド 」 を 参照 し て くだ さい 。 
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M_VGET 


仙 OPM コ ー ル 番号 : $03 OPM コ マン ド : な し 


FM 音源 の 音色 デー タ 取 得 


DOL $FO IOCS コ ー ル 番号 
D1L $03 OPM コ ー ル 番号 
D2L 音色 番号 (1 一 200) 
A1L 音色 デー タ を 格納 する た め の バ ッ フ ァ 先 頭 ア ドレ ス (55 バ イト ) 


por 。 = ラー コー ド 
DO0 上 0 本人 正常 終了 
(A1) 音色 デー タ 


解 説 | FM 音源 の 指定 し た 音色 番号 の デー タ を バッ ファ に コピ ー し ます 。 
入力 の D2L は 、 音 色 番 号 で 1 一 68 は 登録 済 で す 。 
入力 の A1L は 、 音 色 デ ー タ を 格納 する た め の バ ッ フ ァ の 先頭 アド レス で バッ 
ファ サイ ズ は 55 バ イト 必要 で す 。 
な お 、 音 色 デ ー タ の 内 部 形式 は 、M_VSET を 参照 し て くだ さい 。 
リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド 」| を 参照 し て くだ さい 。 
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4. 3 OPMDRV3 IOCS コ ー ル 


la 


@OPM コ ー ル 番号 : $04 OPM コ マン ド : (Vn1n2,data..) 


FM 音源 の 音色 を 
SFO IOCS コ ー ル 番号 


D1L $04  _OPM コ ー ル 番号 
D2L 音色 番号 (1 一 200) 
AE 音色 デー タ の 先頭 アド レス (55 バ イト ) 


り 灸 一 ン | DOL ェ エラ テー コ ロー ド 
DO エー0…… 正 常 終 了 


解 説 | FM 音源 の 指定 し た 音色 番号 に 音色 デー タ を 設定 し ます 。 
入力 の D2L は 、 音 色 番号 で 1 一 68 は 登録 済み で す 。 
入力 の A1L は 、 音 色 デ ー タ の 先頭 アド レス で す 。 
サイ ズ は 55 バ イト で 、 設 定 内 容 は 次 の 通り で す 。 
音色 デー タ の 内 部 形式 


フィ ー ド バッ ク プ アル ゴリ ズム (0 一 63) (0 一 31) 
スロ ッ ト マ スク (0 一 15) (0 一 31) 
ウェ ー プ フォ ー ム (0 一 3) (0 一 31) 
シン クロ 0.1) (0 一 15) 
スピ ー ド (0 一 255) (0 一 15) 
PMD (0 一 127 (0 一 127 の 
AMD (0-7) (0 一 3) 
PMS (0~3) (0 一 15) 
AMS 03) | DT1 (0-7 
L, RPAN (0 一 3) (0 一 3) 

AMS イ ネー プル (01) 


0 
1 
洲 
3 
4 
9 
6 
7 
8 
9 


ュー 
〇 


な お 、 オ ペレ ー タ 1 は M1 (モジ ュ レ ー タ 1) 、 オ ペレ ー タ 2 は C1 (キャ リア 
1) 、 オ ペレ ー タ 3 は M2 (モジ ュ レ ー タ 2) 、 お よび オペ レー タ 4 は C2 (キャ 
リア 2) に 対応 し て いま す 。 

リタ ー ン の D0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド 」| を 参照 し て くだ さい 。 
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M_ TEMPO 


WOPM コ ー ル 番号 : $05 OPM コ マン ド : (On) 


曲 の テン ポ を 指定 
DOL $FO IOCS コ ー ル 番号 


D1L $05 OPM コ ー ル 番号 
D2 エ L テン ポ デ ー タ (20 一 300) 


DOL 現在 の テン ポ 
D2 エ チー1 : 

BE エラー ロー ドド 

DO 上 エー0…… 正 営 終了 


解 説 | FM 音源 お よび MIDI の 演奏 時 の テン ポ を 指定 し ます 。 
入力 の D2L 上 は 、 テ ン ポ で 1 分 間 に 4 分 音符 を いく つ 演 奏で きる か で 指定 し ま 
す 。 
デフ ォ ル ト は 120 で す 。 
入力 の D2.L に 一 1 を 指定 し た 場合 は 、 現 在 の テン ポ を 返し ます 。 
リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド 」 を 参照 し て くだ さい 。 
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4. 3 OPMDRV3 IOCS コ ー ル 


@OPM コ ー ル 番号 : $06 OPM コ マン ド : (Tn) 

指定 トラ ッ ク に MML デ アー タ を セッ ト 

DOL $FO IOCS コ ー ル 番号 
Di1L $O06  OPM コ ー ル 番号 


D21L トラ ッ ク 番 号 (1 一 80) 
A1L MML デ ー タ 先頭 アド レス 


リタ ー ン | DO エ エラ ー コ ー ド 
DO エニ 0…… 正 常 終 了 


指定 の トラ ッ ク へ MML デ ー タ を セッ ト し ます 。 


入力 の A1 し は MML デ ー タ の 先頭 アド レス で 、 終 端 は ヌル 文字 (0) で す 。 
リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド 」| を 参照 し て くだ さい 。 


@⑯OPM コ ー ル 番号 : $07 OPM コ マン ド : な し 
指定 トラ ッ ク バ ッ フ ァ の 残り バイ ト 数 の 取得 
DOL $FO IOCS コ ー ル 番号 


BI $07 OPM コ ー ル 番号 
D2L トラ ッ ク No.(1 一 80) 


DOL 残り バイ ト 数 
指定 の トラ ッ ク バ ッ フ ァ の 残り バイ ト 数 を 返し ます 。 
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M_PLAY 


@OPM コ ー ル 番号 : $08 OPM コ マン ド : (Pn1.n2,…) 


指定 チャ ン ネ ル の 演奏 開始 
DOL $FO IOCS コ ー ル 番号 


D1L $08 OPM コ ー ル 番号 
D2L チャ ン ネ ル の ビッ ト パ タ ー ン 


DE デー 


DO0L 上 デー0…… 正 常 終 了 


解 説 | 指定 の チャ ン ネ ル の 演奏 を 開始 し ます 。 
入力 の D2 上 は 、 演 奏 の 開始 を 指定 する チャ ン ネ ル の ビッ トバ パタ ー ン で 、 ビ ッ 
ト 0 一 24 が チャ ン ネ ル 1 25 に 対応 し て お り 、 演 奏 を 開始 し た い チ ャ ン ネ ル 
に 対応 し た ビッ ト に 1 を 指定 し ます (ビッ ト 25-31 は 常に 0) 。 
ー1 を 指定 し た 場合 は 、 全 て の チャ ン ネ ル の 演奏 を 開始 し ます 。 
リタ ー ン の D0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド 」| を 参照 し て くだ さい 。 
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4. 3 OPMDRV3 IOCS コ ー ル 


1 


WOPM コ ー ル 番号 : $09 OPM コ マン ド : な し 


指定 チャ ン ネ ル の 現在 の 演奏 状態 を 返す 


DO エ $FO IOCS コ ー ル 番号 
NL $09 OPM コ ー ル 番号 
D2L チャ ン ネ ル 番 号 (1 一 25) 


D2 エ L ニ 1 一 25 
DO 上 0…… 停 止 中 
DO0L=1…… 演 奏 中 
D2 エ ニー1 


DOL 演奏 状態 を 示す チャ ン ネ ル の ビッ ト パ タ ー ン 


指定 の チャ ン ネ ル の 現在 の 演奏 状態 を 返し ます 。 

入力 の D2 エ 上 に 一 1 を 指定 し た 場合 は 、 全 て の チャ ン ネ ル の 演奏 状態 を ビッ ト パ 
ター ジ で 人 透 し ます 。 

ビッ ト 0~~24 が チャ ン ネ ル 1 一 25 に 対応 し て お り 、 チ ャ ン ネ ル に 対応 し た 
ビッ ト に 演奏 状態 を セッ ト し ます (ビッ ト 25 一 31 は 常に 0) 。 
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M_STOP 


WOPM コ ー ル 番号 : $0A OPM コ マン ド : (Sn1.n2,…) 


指定 チャ ン ネ ル の 演奏 停止 
DOL SFO IOCS コ ー ル 番号 


D1L $0A OPM コ ー ル 番号 
D2.L チャ ン ネ ル の ビッ ト パ タ ー ン 


por = ッ ー コ ー ド 


DO 上 = デニ 0…… 正 常 終 了 


解 説 | 指定 され た チャ ン ネ ル の 演奏 を 停止 し ます 。 
入力 の D2L は 、 演 奏 の 停止 を 指定 する チャ ン ネ ル の ビッ ト パ タ ー ン で 、 ビ ッ 
ト 0-24 が チャ ン ネ ル 1 25 に 対応 し て お り 、 演 奏 を 停止 きせ た い チ ャ ン ネ 
ル に 対応 し た ビッ ト に 1 を 指定 し ます (ビッ ト 25~-31 は 常に 0) 。 
ー1 を 指定 し た 場合 は 、 全 て の チャ ン ネ ル を 停止 。 
リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、 「5. 1 OPMDRV3 エ ラー 
コー ド 」| を 参照 し て くだ さい 。 
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4. 3 OPMDRV3 IOCS コ ー ル 


FM_CON「ーーーーーーーーーーー 


但 OPM コ ー ル 番号 : $0B OPM コ マン ド : (CO) 


指定 チャ ン ネ ル の 演奏 再開 
DOL $FO IOCS コ ー ル 番号 


D1L $OB  "OPM コ ー ル 番号 
ID の チャ ン ネ ル の ビッ ト パ タ ー ン 


D0L エラ ー ョ ー ド 


DO0.L 三 0…… 正常 終了 


解 説 | 指定 さん れん た チャ ン ネ ル の 演奏 を 再開 し ます 。 
入力 の D2L 上 は 、 演 奏 の 再開 を 指定 する チャ ン ネ ル の ビッ ト パ タ ー ン で 、 ビ ッ 
ト 0 24 が チャ ン ネ ル 1 ^25 に 対応 し て お り 、 演 奏 を 再開 させ た い チ ャ ン ネ 
ル に 対応 し た ビッ ト に 1 を 指定 し ます (ビッ ト 25-31 は 常に 0) 。 
ー1 を 指定 し た 場合 は 、 全 て の チャ ン ネ ル を 再開 。 
リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド 」 を 参照 し て くだ さい 。 


倫 OPM コ ー ル 番号 : $0C OPM コ マン ド : な し 


指定 トラ ッ ク バ ッ フ ァ の 先頭 アド レス 取得 
DOL SFO IOCS コ ー ル 番号 


D1L $OC 。OPM コ ー ル 番号 
D2L トラ ッ ク 番 号 (1 一 80) 


DOL トラッ ク バ ッ フ ァ 先 頭 ア / ド レス 
指定 の トラ ッ ク の トラ ッ ク バ ッ フ アァ 先 頭 ア ドレ ス を 返し ます 。 
トラ ッ ク バ ッ フ ァ は 、OPMDRV3.X の 内 部 バッ ファ の た め 、 ス ー パ ー バ イ 


ザー 領域 で す 。 
デー タ の アク セス に は 、 注 意 し て くだ さい 。 
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分 補 5ーーーーーーーーーー 99ー 幸 コ 


WOPM コ ー ル 番号 : $0F OPM コ マン ド : な し 


指定 トラ ッ ク バ ッ フ ァ の 使用 容量 の 取得 


DOL $FO IOCS コ ー ル 番号 
D1L $OF OPM コ ー ル 番号 
D2 葉 トラ ッ ク 番 号 (1 一 80) 


DO0L バッ ファ 使用 容量 
指定 の トラ ッ ク バ ッ フ ァ に お ける 現在 の 使用 容量 を 返し ます 。 


入力 の D2L に 0 を 指定 し た 場合 は 、80 ト ラッ ク 全 て の 合計 使用 容量 を 返し ま 
す 。 


23MMmfeesrseawamessass デー] 


WOPM コ ー ル 番号 : $10 OPM コ マン ド : (Nc,C) 
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出力 チャ ン ネ ル の 一 時 変更 


DOL $FO IOCS コ ー ル 番号 
D1L $10 OPM コ ー ル 番号 
D2.L チャ ン ネ ル 番 号 X65536 十 出力 チャ ン ネ ル 番 号 


D2.W ニ ー1 

DOL 現在 の 出力 チャ ン ネ ル 番 号 
D2.W チ ー1 

DOL ーー ドド 


DO 上 エニ 0…… 正常 終了 


指定 の チャ ン ネ ル の 出力 チャ ン ネ ル を 一 時 的 に 変更 し ます 。 

MML デ ー タ の ⑨N と は 異な り 、 変 更 前 の チャ ン ネ ル の 各 パ ラメ ー タ (トラ ッ 
ク 番 号 、 音 色 番 号 、 ボ リュ ー ム な ど ) を 引き 継ぎ ます 。 

入力 の D2 上 は 、 上 位 16 ビ ッ ト が チャ ン ネ ル 番 号 (1 一 25) 、 下 位 16 ビ ッ ト が 出 
カカ チャ ン ネ ル 番 号 (1 一 25) で す 。 

出力 チャ ン ネ ル に 一 1 を 指定 し た 場合 は 、 現 在 の 設定 値 を 返し ます 。 

リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド 」| を 参照 し て くだ さい 。 


4. 3 OPMDRV3 IOCS コ ー ル 


M_PROG 


@OPM コ ー ル 番号 : $11 OPM コ マン ド : (Gec,n) 


指定 チャ ン ネ ル の 音色 番号 設定 


解 


ドロ 


D1L $11 OPM コ ー ル 番号 
D2L チャ ン ネ ル 番 号 X65536 十 音色 番号 


D2.W ニ テー1 
DOL 現在 の 音色 番号 
D2.W ま ー1 
DO0L モエ ジー コー ド 
DO0L=0…… 正 常 終了 


指定 の チャ ン ネ ル の 音色 番号 を 設定 し ます 。 

入力 の D2.L は 、 上 位 16 ビ ッ ト が チャ ン ネ ル 番 号 (1 一 25) 、 下 位 16 ビ ッ ト が 音 
色 番 号 (FM 音源 は 1 一 200、MIDI は 1 一 128) で す 。 

チャ ン ネ ル 番 号 に 一 1 を 指定 し た 場合 は 、 全 て の チャ ン ネ ル に 同じ 音色 番号 を 
設定 し ます 。 

音色 番号 に 一 1 を 指定 し た 場合 は 、 現 在 の 設定 値 を 返し ます 。 

リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド 」| を 参照 し て くだ さい 。 
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@OPM コ ー ル 番号 : $12 OPM コ マン ド : (Lcn) 
DO $FO IOCS コ ー ル 番号 
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説 


DiL $12 。OPM コ ー ル 番号 
D2 エ チャ ン ネ ル 番 号 X65536 ボ リューム デ ー タ 


D2.W ニ ー1 
DO0.L 現在 の ボリ ュー ム 

D2.W チ ー1 
DO.L エラ ー コ ー ド 
DO0L エ =0…… 正 常 終 了 


指定 の チャ ン ネ ル に ボリ ュー ム デ ー タ を 設定 し ます 。 

入力 の D2 上 は 、 上 位 16 ビ ッ ト が チャ ン ネ ル 番 号 (1 一 25) 、 下 位 16 ビ ッ ト が ボ 
リュ ー ム デー タ (0~127) で す 。 

チャ ン ネ ル 番 号 に 一 1 を 指定 し た 場合 は 、 全 て の チャ ン ネ ル に 同じ ボリ ュー ム 
デー タ を 設定 し ます 。 

ボリ ュー ム デ ー タ に ー1 を 指定 し た 場合 は 、 現 在 の 設定 値 を 返し ます 。 

リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
ビー ド ] を 基 妥 し て くだ きい 。 


4. 3 OPMDRV3 IOCS コ ー ル 


2 


@OPM コ ー ル 番号 : $13 OPM コ マン ド : (Bcn) 


| 機能 | 
L 入 カ | 


3 三 の 


指定 チャ ン ネ ル の パン ポット 設定 


DOL $FO IOCS コ ー ル 番号 
D1L $13 OPM コ ー ル 番号 
D2L チャ ン ネ ル 番 号 X65536 十 パン ポッ ト デ ー タ 


D2.W ニ テー1 
DO.L 現在 の パン ポッ ト デ ー タ 
D2.W チ ー1 
DO0L エラ ーー ド 
DO 上 エニ 0…… 正 常 終 了 


指定 の チャ ン ネ ル の パン ポッ ト デ ー タ を 設定 し ます 。 

入力 の D2L エ は 、 上 位 16 ビ ッ ト が チャ ン ネ ル 番 号 (1 一 25) 、 下 位 16 ビ ッ ト が パ 
ン ツボ ポ ボット ジ データ (0 一 127) で す 。 

チャ ン ネ ル 番 号 に 一 1 を 指定 し た 場合 は 、 全 て の チャ ン ネ ル に 同じ パン ポッ 
ト デ ー タ を 設定 し ます 。 

パン ポッ ト デ ー タ の デフ ォ ル ト 値 は 64 で す 。 

パン ポッ ト デ ー タ に ーー1 を 指定 し た 場合 は 、 現 在 の 設定 値 を 返し ます 。 


2 パン シン ボット デ ー メ 
0 : ライ ト (右端) 
6 8 : セン ター (中 央 ) 
12 7 ・ レフ ト ( 左 導 ) 


リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド 」| を 参照 し て くだ さい 。 
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M_VEL 


WOPM コ ー ル 番号 : $14 OPM コ マン ド : (Ucn) 


指定 チャ ン ネ ル の ベロ シテ ィ を 設定 
DOL $FO IOCS コ ー ル 番号 


D1L $14 。OPM コ ー ル 番号 
D2L チャ ン ネ ル 番 号 X65536 十 ベロ シテ ィ デ ー タ 


DOL 現在 の ベロ シテ ィ デ ー タ 
D2.W キ ま ー1 
BOL。 ジー コー ド 
DO エー0…… 正 常 終了 


解 説 | 指定 の チャ ン ネ ル の ベロ シテ ィ デ ー タ を 設定 し ます 。 
入力 の D2 し は 、 上 位 16 ビ ッ ト が チャ ン ネ ル 番 号 (1 一 25) 、 下 位 16 ビ ッ ト が ベ べ 
ロ シ テ ィ デ アー タ (0~-127) で す 。 
チャ ン ネ ル 番 号 に 一 1 を 指定 し た 場合 は 、、 全 て の チャ ン ネ ル に 同じ ベロ シテ ィ 
デー タ を 設定 し ます 。 
ベロ シテ ィ デ ー タ の デフ ォ ル ト 値 は 127 で す 。 
ベロ シテ ィ デ ー タ に ー1 を 指定 し た 場合 は 、 現 在 の 設定 値 を 返し ます 。 リ ター 
ン の DO0L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー コー ド ]」 
を 参照 し て くだ さい 。 
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4. 3 OPMDRV3 IOCS コ ー ル 


UN 


⑯OPM コ ー ル 番号 : $15 OPM コ マン ド : (Recn) 


指定 チャ ン ネ ル の 音程 シフ ト 
DOL SEO IOCS コ ー ル 番号 


D1L $15 OPM コ ー ル 番号 
D2L チャ ン ネ ル 番 号 X65536 十 上 トラ ンス ポー ズ デ ー タ 


DOL 現在 の トラ ンス ポー ズ デ ー タ 
D2.W チ ー1 
DOL エラ ー コ ー ド 
DO0L=0…… 正 常 終了 


解 説 | 指定 の チャ ン ネ ル の 音程 を 土 2 オク ター プ の 範囲 で シフ ト し ます 。 
入力 の D2L は 、 上 位 16 ビ ッ ト が チャ ン ネ ル 番 号 (1 一 25) 、 下 位 16 ビ ッ ト が ト 
ラン スポ ー ズ デー タ (0~-48) で す 。 
チャ ン ネ ル 番 号 に 一 1 を 指定 し た 場合 は 、 全 て の チャ ン ネ ル に 同じ トラ ンス 
ポ ボーズ デ ー タ を 設 守 し ます 。 
トラ ンス ポー ズ デ ー タ の デフ ォ ル ト 値 は 64 で す 。 
トラ ンス ポー ズ デ ー タ に 1 を 指定 し た 場合 は 、 現 在 の 設定 値 を 返し ます 。 
リタ ー ン の D0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド 」] を 参照 し て くだ さい 。 
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M_ANTOFF 


@OPM コ ー ル 番号 : $18 OPM コ マン ド : (J9) 


指定 チャ ン ネ ル へ オー ルノー ト オ フ 出力 
DOL $FO IOCS コ ー ル 番号 


D1L $18 。OPM コ ー ル 番号 
D2L チャ ン ネ ル 番 号 (1 一 25) 


p0r = ッ ー コ ー ド 


DO0L= ニ 0…… 正常 終了 


解 説 | 指定 の チャ ン ネ ル へ オー ルノー ト オ フ を 出力 し ます 。 
入力 の D2L に 一 1 を 指定 し た 場合 は 、、 全 て の チャ ン ネ ル ヘ ノー ト オ フ を 出力 
し まず す 。 
リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、 「5. 1 OPMDRV3 エ ラー 
コー ド 」| を 参照 し て くだ さい 。 


M_DIROUT 


@⑯OPM コ ー ル 番号 : $19 OPM コ マン ド : (Xn1.n2...n512) 
MIDI デ ー タ の 出力 
DOL $FO IOCS コ ー ル 番号 


D1L $19 OPM コ ー ル 番号 
D2L デー タ サ イズ 
A1L MIDI デ ー タ の 先頭 アド レス 


ン | DOL 2 
DO 上 L=0…… 正 常 終了 


解 説 | MrDIi デ メー タ を デー タ サ イズ 分 MIDI へ 出力 し ます 。 


リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド | を 参照 し て くだ さい 。 
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4. 3 OPMDRV3 IOCS コ ー ル 


aa 


⑯OPM コ ー ル 番号 : $1A OPM コ マン ド : (En1n2..) 


解 説 


指定 チャ ン ネ ル の 発音 許可 


DOL $FO IOCS コ ー ル 番号 
D1L $1A  OPM コ ー ル 番号 
D2L チャ ン ネ ル の ビッ ト パ タ ー ン 


D2L エ ニー1 
DOL 現在 の 許可 状態 を 示す チャ ン ネ ル の ビッ トバ パタ ー ン 
D2 上 エチ ま ー1 
DOL ジー コー ド 
DO0L= テ 0…… 正 常 終了 


チャ ン ネ ル の ビッ ト パ タ ー ン で 示さ れる チャ ン ネ ル の 演奏 を 、 許 可 (ビッ ト 
三 1) また は 禁止 (ビッ ト =0) し ます 。 

M_STOP と は 異な り 、 内 部 的 に は ノー ト 以 外 の デー タ は 、 継 続 し し て いま す 
(ミュ ー ト 状態 ) 。 

入力 の D2L は 、 発 音 許可 を 指定 する チャ ン ネ ル の ビッ ト パ タ ー ン で 、 ビ ッ ト 
0 ~-24 が チャ ン ネ ル 1 25 に 対応 し て お り 、 発 音 を 許可 し た い チ ャ ン ネ ル に 
対応 し た ビッ ト に 1 を 指定 し ます (ビッ ト 25 一 31 は 常に 0) 。 

ー1 を 指定 し た 場合 は 、 現 在 の 許可 状態 を 示す チャ ン ネ ル の ビッ ト パ タ ー ン を 
5 惨 ま っ 

リタ ー ン の D0 上 L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド 」| を 参照 し て くだ さい 。 
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| 財 に に ー ム ms ニー キー ハー 
@OPM コ ー ル 番号 : $1B OPM コ マン ド : な し 

指定 チャ ン ネ ル ヘ ノー ト オ ン 出力 

DOL $FO IOCS コ ー ル 番号 


D1L $1B  "OPM コ ー ル 番号 
D2 エ # ツ 紗 番 号 X65536 十 /ー ト 番号 X256 十 ぐ 7 イチ ー9 


Por 。 = ター コー ド 


DO0L=0…… 正 常 終 了 


指定 の チャ ン ネ ル へ ノー ト オ ン を 出力 し ます 。 


入力 の D2L は 、 上 位 16 ビ ッ ト が チャ ン ネ ル 番 号 (1 一 25)、 ビ ッ ト 8 一 15 が ノー 
ト 番 号 (0 一 127)、 下 位 8 ビッ ト が ベロ シテ ィ (0 一 127) で す 。 

リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド 」| を 参照 し て くだ さい 。 


M_NTOFF 


WOPM コ ー ル 番号 : $1C OPM コ マン ド : な し 


指定 チャ ン ネ ル ヘ ノート オフ 出力 
DOL $FO IOCS コ ー ル 番号 
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解 


説 


D1L $1C  OPM コ ー ル 番号 
D2L # ャ ツ 密 番号 X65536 十 ノー ト 番号 X256 士 ぐ ロイ 7 -9 


DO0L エタ ダー コー ド 
DO 上 =0…… 正 常 終 了 


指定 の チャ ン ネ ル へ ノー ト オ フ を 出力 し ます 。 

入力 の D2.L は 、 上 位 16 ビ ッ ト が チャ ン ネ ル 番 号 (1 一 25) 、 ビ ッ ト 8 一 15 が 
ノー ト 番 号 (0-127) 、 下 位 8 ビッ ト が ベロ シテ ィ (0-127) で す 。 

リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド 」 を 参照 し て くだ さい 。 


4. 3 OPMDRV3 IOCS コ ー ル 


2 


@OPM コ ー ル 番号 : $20 OPM コ マン ド : (Zn) 


同期 モー ド 設定 
DO0L $FO IOCS コ ー ル 番号 


D1L $20  "OPM コ ー ル 番号 
D2.W 同期 モー ド 


DOL 現在 の 同期 モー ド 
D2.W ま ー1 
DO.L ラー コー ド 
DO0L エ =0…… 正 常 終了 


解 説 | MIDI ク ロッ ク 同 期 モ ー ド を 設定 し ます 。 
入力 の D2.W は 同期 モー ド で 、 設 定 内 容 は 次 の 通り で す 。 
D2.W =0…… 内 部 の MIDI ク ロッ ク に 合わ せ て 演奏 

=1 …… 外 部 の MIDI ク ロッ ク に 合わ せ て 演奏 

=2…… 外 部 の MIDI ク ロッ ク に 合わ せ て 演奏 

= テー1 … 現 在 の 状態 を DO 上 に 返し ます 。 
外部 同期 に する 場合 は 、 同 期 モ ー ド に 1 を 指定 し 、M_SYNC 実 行 後 M_ PLAY 
で 待機 状態 に セッ ト し て MIDI の スタ ー ト コマ ンド ($FA) を 待ち ます 。 
リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド | を 参照 し て くだ さい 。 


249 


第 4 章 追加 DOS プ IOCS コ ー ル 


M_METER 


@OPM コ ー ル 番号 : $21 OPM コ マン ド : (Qn1,n2) 


曲 の 拍子 設定 
DOL $FO IOCS コ ー ル 番号 


D1L  . $21 OPM コ ー ル 番号 
D2L 拍子 の 分 子 メ 65536 十 拍子 の 分 母 


D0r 。 エラ ー コ ー ド 

DO 上 エー0…… 正常 終了 
解 説 曲 の 拍子 を 設定 し ます 。 

入力 の D2 し は 、 上 位 16 ビ ッ ト が 拍子 の 分 子 (1 一 16) 、 下 位 16 ビ ッ ト が 拍子 の 
分 母 (2.4.816) で す 。 
デフ ォ ル ト 値 は 4/ 4 拍子 に 設定 され て いま す 。 
リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド 」| を 参照 し て くだ さい 。 
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4. 3 OPMDRV3 IOCS コ ー ル 


SE 


倫 OPM コ ー ル 番号 : $29 OPM コ マン ド : 無し 


S ND フ ァイル 形式 の デー タ を FM 音源 用 に 登録 


DO $FO IOCS コ ー ル 番号 

D1L $29 。OPM コ ー ル 番号 

D2 エ L デー タ サ イズ (最大 16000 バ イト ) 
A1.L デー タ の 先頭 アド レス 


な し (DO0L の 内 容 は 保証 され ませ ん ) 


SOUND SX 一 68K、SOUND PRO 一 68K の SND フ ァイル 形式 の デー タ を FM 音 
源 用 の 音色 デー タ と し て 登録 し ます 。 

入力 の D2L は 、 デ ー タ サイ ズ で 1 音色 80 バ イト を 最大 200 音 色 分 ( 三 16000 バ 
イト ) まで 指定 で きま す 。 

入力 の A1L は 、SND フ ァイル 形式 の デー タ が 格納 され て いる バッ ファ の 先頭 
アド レス で す 。 

リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
ゴー ド | を 需 照 し て くだ きい 。 
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M_PCMSET 


氏 OPM コ ー ル 番号 : $2A OPM コ マン ド : 無し 


指定 の 音程 に PCM 音 を 登録 
DOL 。 SFO IOCS コ ー ル 番号 
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D1L $2A  。OPM コ ー ル 番号 

D2 エ デー タ サ イズ (最大 32767 バ イト ) 

D3L ノー ト 番 号 X65536 十 サン プリ ング 周波 数 
A1L PCM デ ー タ の 先頭 アド レス 


DOL エラ ー コ ー ド 
DO0 エ =0…… 正 常 終了 


指定 の 音程 に 音 を 登録 し ます 。 使 用 で きる 音程 は C じ 一 1 か ら 'G8' (ノー ト 番 号 
0 一 127 に 対応 ) の 128 音 で す 。 

入力 の D2.L は 、PCM デ ー タ の バイ ト 数 で 一 1 を 指定 し た 場合 は 、PCM バ ッ 
アァ ア を グリ ア し ま チ 。 

入力 の D3 上 は 、 上 位 16 ビ ッ ト が ノー ト 番 号 (0 一 127) 、 下 位 16 ビ ッ ト が サン 
プリ ング 周波 数 (0 一 4) で す 。 


サン プリ ング 周波 数 


0 ee 3.9KHz 
1 POCLCD の .2KHz 
2 PL 7 .8KHz 
3 の 10.4KHz 
4 15.6KHz 


リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド | を 参照 し て くだ さい 。 


4. 3 OPMDRV3 IOCS コ ー ル 


aa 


価 OPM コ ー ル 番号 : $2B OPM コ マン ド : (/OMP) 


チャ ン ネ ル 番 号 の 割り 当て 変更 


DO0L $FO IOCS コ ー ル 番号 
D1L $2B OPM コ ー ル 番号 
D2.W 割り 当て モー ド (0~5) 


D2.W ニー1 
DOL 割り 当て モー ド 
D2.W ま ー1 
DOL 叶 ウ ニー ロード 
DO エニ 0…… 正 常 終了 


各 音 源 に 対す る チャ ン ネ ル 番 号 の 割り 当て モー ド を 設定 し ます 。 
入力 の D2.W は 割り 当て モー ド で 、 設 定 内 容 は 次 の 通り で す 。 
割り 当て モー ド 


0 三 90EBIMIcxxopee OPM 三 ch1 一 8 PCM 三 ch9 MIDI 三 ch10 一 25 
OM < OPM 三 ch1 一 8 MIDI 三 ch9 一 24 PCM 三 ch235 
2=ー"MOP"………… MIDI 三 ch1 一 16  OPM 三 ch17 一 24 PCM 三 ch2S 
うーMDCOD< で co< MIDI 三 ch1 一 16 PCM 三 ch17 OPM 三 ch18 一 25 
4 サー"POMIoszoom・ PCM 三 ch1 OPM 三 ch2 一 9 MIDI 三 ch10 一 25 
9 一 "PMGOIYooovo PCM 三 ch1 MIDI 三 ch2 一 17  OPM 三 ch18 一 25 


入力 の D2.W が 一 1 の 場合 は 現在 の モー ド を DO0. に 返し ます 。 
リタ ー ン の D0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド 」| を 参照 し て くだ さい 。 
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= 3JSESeaawwosssmesma ト ーー ミミー 
⑱OPM コ ー ル 番号 : $2C OPM コ マン ド : 無し 

MIDI イ ンター フェイ ス の 有 無 を 検出 

DOL $FO IOCS コ ー ル 番号 


D1L $2C 。OPM コ ー ル 番号 
り 多 一 2 DOL エラ ー コ ー ド 


DO エー0…… ある 
DO エニ ー1… な い 


AM 


⑱OPM コ ー ル 番号 : $2F OPM コ マン ド : 無し 
ドラ イ バ 起 動 時 の トラ ッ ク バ ッ フ ァ 全 バイ ト 数 を 取得 
DOL $FO IOCS コ ー ル 番号 


D1L $2F "OPM コ ー ル 番号 
リ ター ン | DOL 全 ト ラッ ク バ ッ フ ァ の バイ ト 数 


ドラ イ バ 起 動 時 に 確保 し た トラ ッ ク バ ッ フ ァ の 全 バ イト 数 を 返し ます 。 
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4. 3 OPMDRV3 IOCS コ ー ル 


⑯OPM コ ー ル 番号 : $30 OPM コ マン ド : 無し 
1 バイ ト の デー タ を MIDI へ 出力 
DOL $FO IOCS コ ー ル 番号 


D1L $30 OPM コ ー ル 番号 
D2.B 出力 デー タ (0 一 225) 


な し (DO の 内 容 は 保証 され ませ ん ) 
1 バイ ト デ ー タ を MIDI に 出力 し ます 。 


@ び OPM コ ー ル 番号 : $32 OPM コ マン ド : 無し 
演奏 中 の 小節 番号 取得 
DO エ L $FO IOCS コ ー ル 番号 


D1L $32 OPM コ ー ル 番号 


リタ ー ン | DOL 小節 番号 (0 一 32767) 


現在 演奏 中 の 小節 番号 を 返し ます 。 


MML デ ー タ "| :"" D.S" な どの 繰り 返し 記号 の 場合 は その まま 加算 きれ ます 
の で 、 実 際 の 小節 番号 と は 異な る 場合 が あり ます 。 
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に の M ーーーーーーーーーー す は O_M=- 
@OPM コ ー ル 番号 : $33 OPM コ マン ド : (Yn) 

Y コ マン ド の 解釈 

DOL $FO IOCS コ ー ル 番号 


解 


部 


yi 計 $33 OPM コ ー ル 番号 
D2L 使用 モー ド 


D2L エ ニー1 

DOL 現在 の 使用 モー ド 
D2L ま ー1 

DOL 不定 


Y コ マン ド の 使用 モー ド を 設定 し ます 。 

M_TRK 実 行 前 に 設定 し て くだ さい 。 

入力 の D2 上 は 、Y コ マン ド の 使用 モー ド で す 。 

D2L に 0 を 指定 し た 場合 は 、Y コ マン ド を MIDI の コン トロ ー ル デー タ と し て 
解釈 し 、 1 の 場合 は OPM レジ スタ 書き 換え と 解釈 し ます 。 


ご 0 ん Pre っ fo 


⑯OPM コ ー ル 番号 : $34 OPM コ マン ド : (PMn) 


演奏 開始 小節 の 設定 
DOL $FO "IOCS コ ー ル 番号 
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解 


書 


D1L $34 OPM コ ー ル 番号 
D2.W 小節 番号 (0 一 32767) 


DO エ L エラ ー コ ー ド 
DO 上 エー0…… 正 常 終 了 


M _PLAY で 演奏 を 開始 する 小節 位置 を 設定 し ます 。 

全て の チャ ン ネ ル の MML デ ー タ "1:""D.S" の 1"" D.C." な どの 数 や 位置 が 同 
じ で な いと 正常 な 演奏 が で きま せん 。 

な お 、 一 度 設定 され た 小節 番号 は 、 演 奏 が 終わ る と クリ ア さ れ ま す 。 

リタ ー ン の D0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド 」| を 参照 し て くだ さい 。 


4. 3 OPMDRV3 IOCS コ ー ル 


りり 記 コ | 2 af 


⑯OPM コ ー ル 番号 : $35 OPM コ マン ド : (SMn) 


演奏 停止 小 飾 の 設定 
DO エ L $FO IOCS コ ー ル 番号 


解 


説 


DL $35 OPM コ ー ル 番号 
D2.W 小節 番号 (1 一 32767) 


DO0L つい m 
DO 上 =0…… 正常 終了 


演奏 を 停止 する 小節 位置 を 設定 し ます 。 

全て の チャ ン ネ ル の MML デ ー タ "| :""D.S" の 17" D.C." な どの 数 や 位置 が 同 
じ で な いと 正常 な 演奏 が で きま せん 。 

リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド 」| を 参照 し て くだ さい 。 
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M_MODSNS 


@⑱OPM コ ー ル 番号 : $36 OPM コ マン ド : 無し 


FM 音源 の モジ ュ レ ーション の 深き 設定 
DOL $FO IOCS コ ー ル 番号 


D1L $36 OPM コ ー ル 番号 
D2L モジ ュ レ ーション の 深き (0-127) 


DOL 現在 の モジ ュ レ ーション の 深 さ 
D2.W キ ー1 
DO0L ES デー ド 
D0L エ =0…… 正 常 終了 


解 説 FM 音源 全体 に か か る モジ ュ レ ーション の 深 さ を 設定 し ます 。 
入力 の D2.L は 、FM 音 源 の モジ ュ レ ーション の 深き で 、 一 1 を 指定 し た 場合 
は 、 現 在 の 設定 値 を 返し ます 。 
リタ ー ン の D0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド 」| を 参照 し て くだ さい 。 
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M_PCMREC 


WOPM コ ー ル 番号 : $38 OPM コ マン ド : 無し 


外部 入力 音 の PCM 録 音 
DO0L $FO IOCS コ ー ル 番号 


D1L $38 。OPM コ ー ル 番号 

D2.W サン プリ ング 周波 数 (0 一 4) 

D3 エ バッ ファ サイ ズ (最大 32767 バ イト ) 
A1L PCM デ ー タ バッ ファ の 先頭 アド レス 


DO0.L だ ジー コー ドド 
DO0L ニ 0……… 正常 終了 
0 テー1loww タ イム キー バー 
(A1) PCM デ ー タ 


オー ディ オ 入 力 端 子 よ り 入 力 さ れ た 音 を PCM 録 音 し 、 バ ッ フ ァ に セッ ト し ま 
す 。 

4 秒 以 内 に 音 が 入力 され な けれ ば 、D0L に 一 1 を 返し ます 。 

音 の 頭 出し は 自動 処理 され ます 。 ( 音 が 入力 され た 時 点 で 録音 を 開始 し ま 
まま 2 

入力 の D2.W は サン プリ ング 周波 数 で 設定 内 容 は 、 次 の 通り で す 。 


サン プリ ング 周波 数 

0 …… 3.9KHz ( 1 秒 に つき 1950 バ イト ) 

1 …… $.2KHz ( 1 秒 に つき 2600 バ イト ) 

2 ……7.8KHz ( 1 秒 に つき 3900 バ イト ) 

3……… 10.4KHz (1 秒 に つき 3200 バ イト ) 

4 …… 15.6KHz ( 1 秒 に つき 7800 バ イト ) 
リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド 」| を 参照 し て くだ さい 
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第 4 章 


M_PCMGET 


@⑱OPM コ ー ル 番号 : $39 OPM コ マン ド : 無し 


追加 DOS プ IOCS コ ー ル 


登録 きれ て いる PCM デ ー タ の 取得 


DOL $FO IOCS コ ー ル 番号 


D1L $39 OPM コ ー ル 番号 

D2.W ノー ト 番 号 (0-127) 

D3L バッ ファ サイ ズ (バイ ト 数 ) 

A1L PCM デ ー タ バッ ファ の 先頭 アド レス 


DO0L 読み 込ま れ た デー タ サ イズ 
(A1) PCM デ ー タ 


現在 ドラ イ バ 内 に 登録 きれ て いる 指定 ノー ト 番 号 に 対応 する PCM デ ー タ を 
バッ ファ に セッ ト し ます 。 


時 半 ヘ し に 290 村 PBRRHSSEEE 


僅 OPM コ ー ル 番号 : $3A OPM コ マン ド : 無し 


2 


〇 〉 


0 


指定 の PCM デ ー タ の サイ ズ を 取得 
DO0L $FO IOCS コ ー ル 番号 
D1L $3A  。OPM コ ー ル 番号 
D2.W ノー ト 番 号 (0 一 127) 


DO エ L PCM デ ー タ の サイ ズ (バイ ト 数 ) 


現在 ドラ イ バ 内 に 登録 され て いる 指定 ノー ト 番 号 に 対応 する PCM デ ー タ の サ 
イズ を 返し ます 。 


4. 3 OPMDRV3 IOCS コ ー ル 


US) 


僅 OPM コ ー ル 番号 : $3B OPM コ マン ド : 無し 


PCM の 実行 状態 を 返す 
DOL $FO IOCS コ ー ル 番号 


D1L $3B  OPM コ ー ル 番号 


リタ ー ン | DOL 実行 状態 

DO エニ $00…… 何 も 実行 し て いな い 

DO0 エ =$02…… 出 力 中 (ADPCMOUT,M_PCMON を 実行 中 ) 
DO エニ $04…… 入 力 中 (ADPCMINP,M_PCMREC を 実行 中 ) 
DO エニ $12…… 出 力 中 (ADPCMAOT を 実行 中 ) 

DO エニ $14 …… 入力 中 (ADPCMAIN を 実行 中 ) 

DO エニ $22…… 出 力 中 (ADPCMLOT を 実行 中 ) 

DO0 エ =$24…… 入 力 中 (ADPCMLIN を 実行 中 ) 


現在 の PCM の 実行 状態 を 返し ます 。 


261 


第 4 章 追加 DOS/IOCS コ ー ル 


M_PCMON 


@OPM コ ー ル 番号 : $3C OPM コ マン ド : 無し 


指定 の PCM デ ー タ を 再生 
DOL  $FO IOCS コ ー ル 番号 


D1.L  $3C OPM コ ー ル 番号 
D2L  /-| 番 号 X65536 二 7 リック 周波 数 X256 十 音声 出力 モ - ド * 


な し 
解 現在 ドラ イ バ 内 に 登録 きれ て いる PCM の 、 指 定 ノー ト 番 号 に 登録 され て いる 

デー タ を 再生 し ます 。 

入力 の D2 上 は 、 上 位 16 ビ ッ ト が ノー ト 番 号 (0 一 127) 、 ビ ッ ト 8 一 1 5 が サ 

ンプ リン グ 周 波数 (0 一 4) 下位 8 ビッ ト が 音声 出力 モー ド 13) です 。 


に 


サン プリ ング 周波 数 


0 で の 3.9KHz 
OTC 5.2KHz 
2 ev 7.8KHz 
人 10.4KHz 
4 …… 15.6KHz 


音声 出力 モー ド の 設定 内 容 は 、 次 の 通り で す 。 
音声 出力 モー ド (オー ディ オ 出 力 端子 ) 


2 
3 …… ステ レオ (左右 両方 ) 
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ES 


鎧 OPM コ ー ル 番号 : $3D OPM コ マン ド : 無し 


指定 チャ ン ネ ル へ 各種 の オフ 出力 
陸 ま 還 S2 な 


解 


部 


D1L $3D  "OPM コ ー ル 番号 
D2.W チャ ン ネ ル 番 号 (1 一 25) 


DO0L ジー コー ド 
DO0 エ =0…… 正 常 終 了 


指定 の チャ ン ネ ル に ピッ チ ベ ン ド オ フ ノ モ ジュ レー ショ ング ダン パー オフ ン ノ 
オー ルノー ト オ ブ を 出力 し ます 。 

入力 の D2.W は チャ ン ネ ル 番 号 で ー1 を 指定 し た 場合 は 、 全 て の チャ ン ネ ル へ 
ピッ チ ベ ン ド オ フン モジ ュ レ ーション ノダ ン パ ー オ フン オー ルノー ト オ フ を 
出力 し まず 。 

リタ ー ン の D0L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド 」 を 参照 し て くだ さい 。 
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M_OPMREG 


@OPM コ ー ル 番号 : $3E OPM コ マン ド : 無し 


指定 の OPM レ ジス タ に 値 を セッ ト 
DOL $FO IOCS コ ー ル 番号 


D1L $3E OPM コ ー ル 番号 
D2.W レジ スタ 番号 (0 一 255) 
D3.W OPM へ 書き 込む デー タ (0-255) 


リ ター ン | D3.W=ー1 
DOL 現在 の レジ スタ 値 
DO エニ ー1 書き 換え られ て いな い 
D2.W ニ ー1 
DO0L OPM レ ジス タバ ッ フ ァ の 先頭 アド レス 
上 記 以 外 
DO0L ジワ ーー 選 
DO エー0…… 正 常 終 了 


解 説 指定 の OPM レジ スタ に 値 を セッ ト し ます 。 
入力 の D3.W に 一 1 を 指定 し た 場合 、 指 定 し た OPM レ ジス タ の 値 を 返し ます 。 
一 度 も 指定 の OPM レ ジス タ が 書き 換え られ て いな い 場 合 、 一 1 を 返し ます 。 
D2.W に 一 1 を 指定 し た 場合 、OPM レ ジス タ の 先頭 アド レス を 返し ます 。 
OPM レ ジス タバ ッ フ ァ は 各 レ ジス タ に つき 2 バイ ト ず つ 計 512 バ イト 有り 、 現 
在 ま で に レジ スタ が 書き 換え られ て な か っ た 場合 は 、 そ の レジ スタ の 位置 に 
ー1 (ワー ド ) が セッ ト さ れ て いま す 。 
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人 


@OPM コ ー ル 番号 : $3F OPM コ マン ド : 無し 


| 入 | 


解 説 


MIDI 制 御 IC の レジ スタ に 値 を セッ ト 


DO0L $FO IOCS コ ー ル 番号 
D2L グル ー プ 番号 X65536 エ アド レス 番号 


DO0L ジー ロー ド 
DO 上 デニ 0…… 正常 終了 


MIDI 制 御 IC (YM3802) の レジ スタ に 値 を 書き 込み ます 。 

入力 の D2.L は 、 上 位 16 ビ ッ ト が グル ー プ 番号 (0-9) 、 下 位 ビ ッ ト が アド レ 
ス 番号 (0 一 7) で す 。 

リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド 」| を 参照 し て くだ さい 


注 : 間違っ た パラ メー タ を 指定 する と 、 シ ステ ム が 正常 に 動作 し な く な る 場 
合 が あり ます 。 
YM3802 の 機能 を 十分 に 理解 の 上 で ご 使用 くだ さい 。 


la 


@OPM コ ー ル 番号 : $40 OPM コ マン ド : (Vnname) 


FM 音源 の 音色 名 の 登録 


DOL $FO IOCS コ ー ル 番号 
D1L $40 "OPM コ ー ル 番号 
D2.W 音色 番号 (1 一 200) 

A1L 音色 名 の 先頭 アド レス 


DO0L F ウッー コー ド 
DO 上 デニ 0…… 正 常 終 了 


FM 音源 の 音色 番号 で 示さ れる 音色 デー タ に 音色 名 を 登録 し ます 。 (半角 で 10 
文字 以内 ) 
リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド 」 を 参照 し て くだ さい 。 
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FNMGE キ ーーーーー ゴ 和 - 


@OPM コ ー ル 番号 : 


$41 OPM コ マン ド : 無し 


FM 音源 の 音色 名 の 取得 


D1.L 
D2.W 
A1L 


DO0L 


$FO IOCS コ ー ル 番号 

$41 OPM コ ー ル 番号 

音色 番号 (1 一 200) 

音色 名 を 格納 する た め の バ ッ フ ァ 先 頭 ア ドレ ス 


ラー コー ド 


DO0L 三 0…… 正常 終了 


(A1) 


音色 名 


解 説 | FM 音源 の 音色 番号 で 示さ れる 音色 デー タ に 登録 きれ て いる 音色 名 を 取得 し ま 
す (半角 で 10 文 字 以 内 ) 。 
リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド 」| を 参照 し て くだ さい 。 


El 


@OPM コ ー ル 番号 : 


$42 OPM コ マン ド : (/Anname) 


PCM 音 色 名 の 登録 


por 
D1L 
D2.W 
『。 敵 


リタ ー ン por 


$FO IOCS コ ー ル 番号 
$42 OPM コ ー ル 番号 
ノー ト 番 号 (0 一 127) 
音色 名 の 先頭 アド レス 


エラ ー コ ー ド 


DO 上 エー0…… 正 常 終了 


PCM の ノー トト 番号 に 音色 名 を 登録 し ます 。 (半角 で 10 文 字 以内 ) 
リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド | を 参照 し て くだ さい 。 
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aa 


氏 OPM コ ー ル 番号 : $43 OPM コ マン ド : 無し 


入 | p0D $FO IOCS コ ー ル 番号 


D1L $43 OPM コ ー ル 番号 
D2.W ノー ト 番 号 (0 一 127) 
A1L 音色 名 を 格納 する た め の バ ッ フ ァ 先 頭 ア ドレ ス 


DO0L SF ジー コー ド 
DO 上 =0…… 正 常 終了 
(A1) 音色 名 


PCM 音 源 の 音色 名 を 取得 し ます 。 (半角 で 10 文 字 以 内 ) 
リタ ー ン の D0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド | を 参照 し て くだ さい 。 


aa 


@ び OPM コ ー ル 番号 : $44 OPM コ マン ド : (70)~(/127) 


機 能 


マス ター ボリ ュー ム の 設定 


入 カカ DO0L $FO IOCS コ ー ル 番号 


1 
に 


D1.L $44 OPM コ ー ル 番号 
D2.W マス ター ボリ ュー ム (0~127) 


D2.W ニ ー1 
DOL 現在 の マス ター ボリ ュー ム 
D2.W ま ー1 
DO0L ジー コー ド 
DO 上 0…… 正 常 終 了 


マス ター ボリ ュー ム を 設定 し ます (デフ ォ ル ト 値 は 127) 。 

入力 の D2.W に 一 1 を 指定 し た 場合 は 、 現 在 の 設定 値 を 返し ます 。 

M_INIT を 実行 する まで 有効 で す 。 

リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド 」 を 参照 し て くだ さい 。 
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M_BEND 


@OPM コ ー ル 番号 : $45 OPM コ マン ド : 無し 
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指定 チャ ン ネ ル の ピッ チ ベ ン ド 設 定 


DOL $FO IOCS コ ー ル 番号 
D1L $45 OPM コ ー ル 番号 
D2L チャ ン ネ ル 番 号 X65536 二 ピッチ ベン ド デ ー タ 


DO0L エラ ー コ ー ド 
DO0L=0…… 正 常 終了 


指定 の チャ ン ネ ル に ピッ チ ベ ン ド を 設定 し ます 。 

入力 の D2 上 は 、 上 位 16 ビ ッ ト が チャ ン ネ ル 番 号 (1 一 25) 、 下 位 16 ビ ッ ト が 
ピッ チ ベ ン ド デ ー タ (0~-127) で す 。 

チャ ン ネ ル 番 号 に 一 1 を 指定 し た 場合 は 、 全 て の チャ ン ネ ル に 同じ ビ ピッチ ベ ン 
ド デ ー タ を 設定 し ます 。 

リタ ー ン の DO0.L し の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド 」| を 参照 し て くだ さい 。 


4. 3 OPMDRV3 IOCS コ ー ル 


| 


@OPM コ ー ル 番号 : $46 OPM コ マン ド : 無し 


指定 チャ ン ネ ル の モジ ュ レ ーション 設定 


DOL $FO IOCS コ ー ル 番号 
D1L $46 OPM コ ー ル 番号 
D2L チャ ン ネ ル 番 号 X65536 士 モジュレーション デー タ 


DO0L sn ジーコ ロード 
DO 上 =0…… 正常 終了 


指定 の チャ ン ネ ル の モジ ュ レ ーション を 設定 し ます 。 

入力 の D2 上 は 、 上 位 16 ビ ッ ト が チャ ン ネ ル 番 号 (1 一 25) 、 下 位 16 ビ ッ ト が モ 
ジュ レー ショ ン デ ー タ (0 一 127) で す 。 

チャ ン ネ ル 番 号 に 一 1 を 指定 し た 場合 は 、 全 て の チャ ン ネ ル に 同じ モジ ュ レ ー 
ショ ン デ ー タ を 設定 し ます 。 

リタ ー ン の D0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド 」| を 参照 し て くだ さい 。 
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M OPMEXC 


@OPM コ ー ル 番号 : $47 OPM コ マン ド : (/En) 
FM 音源 の パラ メー タ セ ッ ト の 選択 
DO エ L $FO IOCS コ ー ル 番号 


D1L $47 OPM コ ー ル 番号 
D2.W パク メー タク 履 ド ー 


DOL 現在 の パラ メー タ セ ッ ト モ ー ド 
D2.W チ ー1 
NL "人 ぎ ーー ぱー デー ド 
DO0L=0…… 正 常 終 了 


FM 音源 に セッ ト す る 音色 パラ メー タ の 内 、LFQ プ PMD プ AMD な どの 全体 に 
影響 する パラ メー タ を 音色 切り 替え 時 に セッ ト す る か どう か を 選択 し ます 。 
入力 の D2.W の 設定 内 容 は 次 の 通り で す (デフ ォ ル ト 値 は 1) 。 


ルー グ 導 みみ ド 年 一 


リタ ー ン の D0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド 」| を 参照 し て くだ さい 。 
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4. 3 OPMDRV3 IOCS コ ー ル 


ん 


@OPM コ ー ル 番号 : $48 OPM コ マン ド : (/SPn) 
FM 音源 の LFO の 発振 周波 数 の 設定 
DOL SFO IOCS コ ー ル 番号 


D1L $48 OPM コ ー ル 番号 
D2.W スピ ー ド デー タ (0~255) 


リ 婦 一 ン | D2.W テ ー1 
DOL 現在 の スピ ー ド デー タ 
D2.W チ ー1 
D0 エ フー リド 
DO0 エ =0…… 正 常 終 了 


FM 音源 の 発振 周波 数 を 設定 し ます 。 
入力 の D2.W ス ピー ド デ ー タ で 、 デ フォ ルト 値 は 198 で す 。 
ー1 を 指定 し た 場合 は 、 現 在 の 設定 値 を 返し ます 。 
リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド | を 参照 し て くだ きい め 。 
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M_PGMFLT 


@OPM コ ー ル 番号 : $49 OPM コ マン ド : 無し 


MML 音 色 切り 替え コマ ンド の 出力 選択 
DOL $RO IOCS コ ー ル 番号 
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DiL $49 。 OPM コ ー ル 番号 
D2.W チャン ネル 番号 X65536 キ エフィル タモ ー ド 


D2.W ニ ー1 
DOL 現在 の フィ ル タ モ ー ド 
D2.W チ ー1 
IDOL ユエ ラー ロー ンド 
DO0L= テ 0…… 正 常 終了 


MML デ ー タ 内 の 音色 切り 替え コマ ンド (⑨n) を 、 指 定 チ ャ ン ネ ル の 演奏 時 に 出 
力 す る か どう か を 選択 し ます 。 

入力 の D2 上 は 、 上 位 16 ビ ッ ト に チャ ン ネ ル 番 号 (1 一 25) 、 下 位 16 ビ ッ ト が 音 
色 切 り 替 え コ マン ド の フィ ル タ モ ー ド で す 。 

チャ ン ネ ル 番 号 に 一 1 を 指定 し た 場合 は 、、 全 て の チャ ン ネ ル に 同じ フィ ル タ 
モー ド を 設定 し ます 。 


フィ ルター モー ド の 設定 内 容 は 次 の 通り で す 。 
人 No フィ ルタオ フ (@n を 出力 する ) 
1 …… フィ ルタオ ン (@n を 出力 し な い ) 
三 1] ze 現在 の 設定 値 を 返す 


リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド | を 参照 し て くだ さい 。 


4. 3 OPMDRV3 IOCS コ ー ル 


1 


⑱OPM コ ー ル 番号 : $4A OPM コ マン ド : 無し 


MML ボ リュ ー ム コマ ンド の 出力 選択 


DOL $FO IOCS コ ー ル 番号 
D1L $4A OPM コ ー ル 番号 
D2.W チャ ン ネ ル 番 号 X65536 キ フィ ル タ モ ー ド 


D2.W ニ ー1 
DOL 現在 の フィ ル タ モ ー ド 
D2.W ま ー1 
DO0L 2 ラー 選 ー ド 
DO0L=0…… 正 常 終 了 


MML デ ー タ 内 の ボリ ュー ム 設 定 コ マン ド (Vn/@Vn) を 、 演 奏 時 に 出力 する 
か どう か を 選択 し ます 。 

入力 の D2 上 は 、 上 位 16 ビ ッ ト に チャ ン ネ ル 番 号 (1 一 25) 、 下 位 16 ビ ッ ト が ボ 
リュ ー ム 設定 コマ ンド の フィ ル タ モ ー ド で す 。 

チャ ン ネ ル 番 号 に 一 1 を 指定 し た 場合 は 、 全 て の チャ ン ネ ル に 同じ フィ ル タ 
モー ド を 設定 し ます 。 


フィ ルター モー ド の 設定 内 容 は 次 の 通り で す 。 
0 …… フィ ルタオ フ (Vn/@Vn を 出力 する ) 
1 …… フィ ルタオ ン (Vn/@Vn を 出力 しない ) 
ー 1 …… 現在 の 設定 値 を 返す 。 


リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド | を 参照 し て くだ さい 。 
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M_PANFLT 


@⑱OPM コ ー ル 番号 : $4B OPM コ マン ド : 無し 


パン ポ ボット 設定 コマ ンド の 出力 選択 
DOL $FO IOCS コ ー ル 番号 


D1L $4B OPM コ ー ル 番号 
D2.W チャ ン ネ ル 番 号 X65536 十 フィルタ モー ド 


リ ターン | D2.W テ ー1 
DO0L 現在 の フィ ル タ モ ー ド 
D2.W ま ー1 
DOL ラー コー ド 
DOL=0…… 正 常 終了 


解 説 | MML デ ー タ 内 の パン ポッ ト 設 定 コ マン ド (Pn@Pn) を 、 指 定 チ ャ ン ネ ル の 演 
奏 時 に 出力 する か どう か を 選択 し ます 。 
入力 の D2 上 は 、 上 位 16 ビ ッ ト に チャ ン ネ ル 番 号 (1 一 25) 、 下 位 16 ビ ッ ト が パ 
ン ポ ッ ト 設 定 コ マン ド の フィ ルター モー ド で す 。 
チャ ン ネ ル 番 号 に 一 1 を 指定 し た 場合 は 、 全 て の チャ ン ネ ル に 同じ フィ ルター 
モー ド を 設定 し ます 。 


フィ ル タ モ ー ド の 設定 内 容 は 次 の 通り で す 。 
0 …… フィ ルタオ フ (Pn/@Pn 出 力 す る ) 
1 …… フィ ルタオ ン (Pn/@Pn 出 力 し な い ) 
ー 1 …… 現在 の 設定 値 を 返す 。 


リタ ー ン の DO0.L の エラ ー コ ー ド に つい て は 、「5. 1 OPMDRV3 エ ラー 
コー ド | を 参照 し て くだ さい 。 
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4. 3 OPMDRV3 IOCS コ ー ル 


人 


⑯OPM コ ー ル 番号 : $5E OPM コ マン ド : 無し 
OPMDRV3.X バ ー ジ ョ ン と 作成 日 付 の 取得 


DO エ L $FO IOCS コ ー ル 番号 


D1L $SE  OPM コ ー ル 番号 
リタ ー ン | DOL バー ジョ ン と 作成 年 月 日 


OPMDRV3.X の バー ジョ ン と 作成 年 月 日 を 返し ます 。 


D31 D30 D29 D28 D27 D26 D23 D24 D23 D22 D21 D20 D19 D18 D17 D16 
バー ジョ ン (BCD) 年 (BCD) 


D15 D14 D13 D12 D11 D10 DO9 DO8 DO7 DO6 DOS DO4 DO3 DO2 DO1 DOO 


例 ) バー ジョ ン 1. 0 1992 年 3 月 3 日 作成 
$10920303 
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SCSI IOCS コ ー ル 


「C compiler PRO 一 68K ver2.1 NEW KIT| で は 、 次 の 様 に し て IOCS コ ー ル を 利用 する こ 


と が で きま す 。 
moveq.1 SCSI コ ー ル 番号 , D1 
moveq.1 #$fS5, DO 
trap #15 


(SCSI の IOCS コ ー ル 番号 は 全て $FS で す 。) 
例 ) SPC の リセ モッ ト お よび SCSI バ ス の リセ ッ ト 
moveq.1 的 00,D1 
moveq.1 5FS, DO 
frap #15 
また は マク ロ を 使用 し て 
include iocscallmac 


moved.1! #S_RESET 
IOCS _SCSIDRV 


IOCS コ ー ル の 詳細 説明 は 、「 プ ログ ラマ ー ズ マニ ュ ア ル 第 3 章 IOCS コ ー ル 」 を 参照 し て 


くだ さい 。 
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4. 4 SCSIIOCS コ ー ル 


僅 ラ イブ ラリ ーー 覧 (SCSI コ ー ル 番号 順 ) 


名 前 機 能 頁 」 
S_ CMDOUT コマ ンド アウ ト フ ェ ー ズ の 実行 279 
S_DATAIN デー タイ ン フ ェ ー ズ の 実行 279 
S_DATAOUT デー タ ア ウト フェ ー ズ の 実行 280 
S_FORMAT SCSI 装 置 の フォ ー マ ッ ト 284 
S_INQUIRY INQOUIRY デ ー タ の 要求 282 
S_MSGIN メー セー ジイ ン フ ェ ー ズ の 実行 281 
S_MSGOUT メッ セー ジア ウト フェ ー ズ の 実行 281 
S_PAMEDIUM メデ ィ ア の イジ ェクト の 禁止 ・ 許 可 を 設定 289 
S_PHASE フェ ー ズ セン ス 282 
S_READ SCSI 装 置 よ り デ ー タ の 読み 込み 283 
S_READCAP SCSI の 容量 に 関す る 情報 を 調べ る 285 
S_READEXT 拡張 READ コ マン ド 285 
S_REASSIGN プロ ッ ク 有 再 配 置 288 
S_ REZEROUNIT SCSI 装 置 を 指定 の 状態 に セッ ト 286 
S_RESET SPC の リセ ッ ト お よび SCSI バ スリ セッ ト 278 
S_REQUEST SCSI 装 置 の セン ター デー タ を 調べ る 287 
S_SEEK 指定 の 論理 プロ ッ ク ア ドレ ス ヘ へ シーク す る 287 
S_SELECT アー ビ ト レー ショ ンプ セレ クシ ョ ン フ ェ ー ズ の 実行 | 278 
S_STARTSTOP SCSI ア クセ ス 制 御 288 
S_STSIN ステ ー タ スイ ン フ ェ ー ズ の 実行 280 
S_TESTUNIT SCSI 装 置 が 動作 可能 で ある か どう か を 調べ る 284 
S_ WRITE SCSI 装 置 へ の デー タ の 書き 込み 283 
S_WRITEEXT 拡張 WRITE コマ ンド | 286 


@/ プ 


第 4 章 追加 DOS プ IOCS コ ー ル 


5 千 ESET 
@ S RESET IOCS コ ー ル 番号 : $F5 SCSI コ ー ル 番号 : $00 


SPC (SCSI プ ロコ トル コン トロ ー ラ ) の リセ ッ ト お よび SCSI バ スリ セッ ト 
DO エ L $FS IOCS コ ー ル 番号 


D1L $00 SCSI コ ー ル 番号 


リ ター ン | な し (DOL は 内 容 が 保証 され ませ ん ) 


SPC の 初期 化 、SCSI バ ス の リセ ッ ト を 行い ます 。 


SCSI バ スリ セッ ト 後 に 2 秒間 待機 し ます 。 


の SELECT 


@ S SELECT IOCS コ ー ル 番号 : $F5 SCSI コ ー ル 番号 : $01 


アー ビ ト レー ショ ン フ ェ ー ズ と セレ クシ ョ ン フ ェ ー ズ の 実行 
DOL $FS IOCS コ ー ル 番号 


D1.L $01 SCSI コ ー ル 番号 
D4.L ター ゲッ ト の ID 
時 、e >4 DE エラ ー コ ー ド (0 以外 な ら 異 常 終了 ) 


解 説 | アー ビ ト レー ショ ン フ ェ ー ズ と セレ クシ ョ ン フ ェ ー ズ を 実行 し ます 。 
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4. 4 SCSIIOCS コ ー ル 


| 


信 S CMDOUT IOCS コ ー ル 番号 : $F5 SCSI コ ー ル 番号 : $03 


コマ ンド アウ ト フ ェ ー ズ の 実生 


入 カ 


DO0L 
D1.L 
D3 工 
A1L 


DOL 


$FS IOCS コ ー ル 番号 

$03 SCSI コ ー ル 番号 

コマ ンド の バイ ト 数 (グル ー プ 0/1/5 以 外 の と き ) 

CDB (COMMAND DISCRIPTORBLOCK) の 先頭 アド レス 


エラ ジー コード 


コマ ンド フェ ー ズ を 実行 し ます 。 
A1L の アド レス か ら そ の コマ ンド の バイ トト 数 分 の デー タ を SCSI バ ス 上 に 出力 


屋 ま かぁ 


グル ー プ 0O/1/5 以 外 の コマ ンド の と き は D3 上 に バイ ト 数 を 指定 し て くだ さい 。 
リタ ー ン の DOL の エラ ー コ ロー ド に つい で は 。 | 5。 3 SCSI エ ラー ロード] 
を 参照 し て くだ さい 。 


SG 52 UN 


念 S DATAIN IOCS コ ー ル 番号 : $F5 SCSI コ ー ル 番号 : $04 


デー タイ ン フ ェ ー ズ の 実生 


DO0.L 
D1L 
D3L 
Ai 


DO エ 


$EFS IOCS コ ー ル 番号 
$O4 SCSI コ ー ル 番号 
読み 込み バイ ト 数 
読み 込み 先頭 アド レス 


モジラ トー コー ド 


デー タイ ン フ ェ ー ズ を 実行 し ます 。 

A1L の アド レス へ D3L 上 バイ ト の デー タ を SCSI か ら 読 み 込み ます 。 

リタ ー ン の D0.L の エラ ー コ ー ド に つい て は 、「5. 3 SCSI エ ラー コー ド ] 
を 参照 し て くだ さい 。 
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S_DATAOUT 


@ S DATAOUT IOCS コ ー ル 番号 : $F5 SCSI コ ー ル 番号 : $05 


機 能 | アー タ ア ウト フェ ー ズ の 実行 


六 衝 | ME $FS IOCS コ ー ル 番号 
D1L $05 SCSI コ ー ル 番号 
D3L 書き 込み バイ ト 数 
A1L 書き 込み 先頭 アド レス 
リタ ー ン DOL エラ ー コ ー ド 


解 説 | デア ー タ アウ ゥ ト フ ェ ー ズ を 実行 し ます 。 
A1L の アド レス か ら D3L バ イト の デー タ を SCSI へ 書き 込み ます 。 
リタ ー ン の D0L の エラ ー コ ー ド に つい て は 、「5. 3 SCSI エ ラー コー ド ]」 
を 参照 し て くだ さい 。 


S_ SISIN 


@ S STSIN IOCS コ ー ル 番号 : $F5 SCSI コ ー ル 番号 :$06 
機 能 | ステ ー タ スイ ン フ ェ ー ズ の 実行 


D0 エ $FS IOCS コ ー ル 番号 


D1L $06 SCSI コ ー ル 番号 
A1L 読み 込み 先頭 アド レス 
リ ター ン | DOL エラ ー コ ー ド 


解 説 | ステ ー タ スイ ン フ ェ ー ズ を 実行 し ます 。 
A1L の アド レス へ 1 バイ ト の デー タ を SCSI バ ス か ら 読 み 込み ます 。 
リタ ー ン の DO0L の エラ ー コ ー ド に つい て は 、「5. 3 SCSI エ ラー コー ド 」 
を 参照 し て くだ さい 。 


2 


ey) 


0 


4. 4 SCSIIOCS コ ー ル 


LS_MSGI ペ ーーーーーーーーーーー- コ 


信 S MSGIN IOCS コ ー ル 番号 : $F5 SCSI コ ー ル 番号 : $07 
メッ セー ジイ ン フ ェ ー ズ の 実行 
DO0L $FS IOCS コ ー ル 番号 


D1L $07 SCSI コ ー ル 番号 
A1L 読み 込み 先頭 アド レス 
リ ター ン | DOL エラ ー コ ー ド 


解 説 | メッ セー ジイ ン フ ェ ー ズ を 実行 し ます 。 
A1L の アド レス へ 1 バイ ト の デー タ を SCSI バ ス 上 か ら 読 み 込み ます 。 
リタ ー ン の DO0L の エラ ー コ ー ド に つい て は 、「5. 3 SCSI エ ラー コー ド 」 
を 参照 し て くだ さい 。 


FLS_MSGOU1ーーーーーーーーー 


@ S MSGOUT IOCS コ ー ル 番号 : $F5 SCSI コ ー ル 番号 : $08 


メッ セー ジア ウト フェ ー ズ の 実行 
DOL $FS IOCS コ ー ル 番号 


D1L $08 SCSI コ ー ル 番号 
と 自 書き 込み 先頭 アド レス 


人 カ 
Por = ラー コー ド 
メッ セー ジア ウト フェ ー ズ を 実行 し ます 。 


A1L の アド レス か ら 1 バイ ト の デー タ を SCSI バ ス 上 へ 書き 込み ます 。 
リタ ー ン の DO0L 上 の エラ ー コ ー ド に つい て は 、「5. 3 SCSI エ ラー コー ド ]」 
を 参照 し て くだ さい 。 
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ラーPPDNS テ ーーーーーーーー ド FSS- で っ 
@ S PHASE IOCS コ ー ル 番号 : $F5 SCSI コ ー ル 番号 : $09 
フェ ー ズ セン ス 


DO0L $FS IOCS コ ー ル 番号 
D1L $09 SCSI コ ー ル 番号 


リ ター ン | DOL 現在 の フェ ー ズ 


SPC の PSNS レ ジス タ (「5. 3 SCSI エ ラー コー ド 」 を 参照 ) を 読み だ し ま 


oO 


EC に LMJUIaaameeseefesrrYYiRr ア 5 


@ S_INQUIRY IOCS コ ー ル 番号 : $F5 SCSI コ ー ル 番号 :$20 


INQUIRY デ ー タ の 要求 
DOL $FS IOCS コ ー ル 番号 


D1L $20 SCSI コ ー ル 番号 
D3L 読み 込み バイ ト 数 
D4L ター ゲッ ト の ID 
A1L 読み 込み 先頭 アド レス 
DOL ステ ー タ ス (上 位 ニ メッ セー ジイ ン フ ェ ー ズ で 得 た 情報 下位 
ニス テー タス イン フェ ー ズ で 得 た 情報 ) 
ー1 な ら 異 常 終了 


A1L の アド レス へ D3L バ イト の INOUIRY デ ー タ を 読み 込み ます 。 
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人 


@ S READ IOCS コ ー ル 番号 : $F5 SCSI コ ー ル 番号 : $21 


SCST 装 置 よ り ア デー タ の 読み 込み 
DOL $FS IOCS コ ー ル 番号 


D1L $21 SCSI コ ー ル 番号 

D2 エ L 目的 読み 込み 位置 (物理 プ ブロッ ク 番 号 ) 
D3 エ L 読み 込み プロ ッ ク 数 (論理 プ ブロック 数 ) 
D4L ター ゲッ ト の ID 

SE 1 プロ ッ ク の 容量 (0 三 256/1= ニ 512/2ー1024) 
1 読み 込み 先頭 アド レス 


DOL ステ ー タ ス (上 位 ニ メッ セー ジイ ン フ ェ ー ズ で 得 た 情報 下位 
デー ステ ー タ スイ ン フ ェ ー ズ で 得 た 情報 ) 
ー1, 一 2 な ら 異 常 終了 


解 説 | D2L の 論理 プロ ッ ク 番 号 か ら D3.L プ ロッ ク 分 の デー タ を AI1.L の 7 ドル へ 読み 
込み ます 。 1 プロ ッ ク の 容量 は 3 以上 を 指定 で きま せん 。 


aa 


念 S WRITE IOCS コ ー ル 番号 : $F5 SCSI コ ー ル 番号 : $22 
SCSI 装 置 へ の デー タ の 書き 込み 
pr SFS 1OCS コ ー ル 番号 


D1L $22 SCSI コ ー ル 番号 
D2L 目的 書き 込み 位置 (論理 プロ ッ ク 番 号 ) 
D3L 書き 込み ブロック 数 (論理 プ ブロッ ク 数 ) 
D4L ター ゲッ ト の ID 
DSL 1 プロ ッ ク の 容量 (0 三 256/1 三 512/2 三 1024) 
A1L 書き 込み 先頭 アド レス 
は 竣 王 ン | D0L ステ ー タ ス (上 位 ニ メッ セー ジイ ン フ ェ ー ズ で 得 た 情報 ノ 下位 


ニス テー タス イン フェ ー ズ で 得 た 情報 ) 


解 説 | D2L の 論理 プロ ッ ク 番 号 か ら D3 上 プロ ッ ク 分 の デー タ を A1L の アド レス か ら 
書き 込み ます 。 1 プ ブロッ ク の 容量 は 3 以上 を 指定 で きま せん 。 
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S FORMAT 


@ S FORMAT IOCS コ ー ル 番号 : $F5 SCSI コ ー ル 番号 : $23 


SCSI 装 置 の フォ ー マ ッ ト 


DOL $FS IOCS コ ー ル 番号 
D1L $23 SCSI コ ー ル 番号 
D3 エ L イン ター リー ヴ 
D4 エ L ター ゲッ ト の ID 
DO0L ステ ー タ ス (上 位 ニ テ メ ッ セー ジイ ン フ ェ ー ズ で 得 た 情報 下位 
ーー ステ ー タ スイ ン フ ェ ー ズ で 得 た 情報 ) 
ー1 な ら 異 常 終了 


指定 の イン ター リー プ 値 で SCSI 装 置 を フォ ー マ ッ ト し ます 。 


S 「ESTUNIT 


@⑯ S TESTUNIT IOCS コ ー ル 番号 : $F5 SCSI コ ー ル 番号 : $24 


2 


CoO 


4 


SCSI 装 置 が 動作 可能 で ある か どう か を 調べ る 。 


DOL $FS IOCS コ ー ル 番号 
D1L $24 SCSI コ ー ル 番号 
D4 エ L ター ゲッ ト の ID 
DO0L ステ ー タ ス (上 位 ニ メッ セー ジイ ン フ ェ ー ズ で 得 た 情報 下位 
ニス テー タス イン フェ ー ズ で 得 た 情報 ) 
ー1 な ら 尋 常 終了 


SCSI 装 置 が 動作 可能 で ある か どう か を 調べ る 。 リ ター ン の DO0.L が 0 の み 動 作 可 
能 で す 。 


4. 4 SCSIIOCS コ ー ル 


EE 


人 @ S READCAP IOCS コ ー ル 番号 : $F5 SCSI コ ー ル 番号 : $25 


SCSI の 容量 に 関す る 情報 を 調べ る 。 
DOL $FS IOCS コ ー ル 番号 


D1L $25 SCSI コ ー ル 番号 
D4L ター ゲッ ト の ID 
A1L 読み 込み 先頭 アド レス 


リタ ー ン | por ステ ー タ ス (上 位 ニ メッ セー ジイ ン フ ェ ー ズ で 得 た 情報 下位 
ニス テー タス イン フェ ー ズ で 得 た 情報 ) 
ー1 な ら 常 終了 


A1L の アド レス へ 4 ワー ド の READ CAPACITY デ ー タ を 読み 込み ます 。 


aa 


@ S READEXT IOCS コ ー ル 番号 : $F5 SCSI コ ー ル 番号 : $26 


拡張 R E AD コマ ンド 
DOL $FS IOCS コ ー ル 番号 


D1L $26 SCSI コ ー ル 番号 
D2L 目的 読み 込み 位置 (論理 プロ ッ ク 番 号 ) 
D3 エ L 読み 込み プロ ッ ク 数 (物理 セク タ 数 ) 
D4 エ L ター ゲッ ト の ID 
DSL 1 プロ ッ ク の 容量 (0 ニ 256/1 三 512/2 三 1024) 
上 読み 込み 先頭 アド レス 
リタ ー ン | DOL ステ ー タ ス (上 位 ニ メッ セー ジイ ン フ ェ ー ズ で 得 た 情報 下位 


ニス テー タス イン フェ ー ズ で 得 た 情報 ) 
ー1, 一 2 な ら 異 常 終了 


解 説 | グル ー プ 1 の コマ ンド 。 読み 込み プロ ッ ク 長 は 65.535 プ ロッ ク ま で 指定 可能 。 
D2L の 論理 プロ ッ ク 番 号 か ら D3 上 プロ ッ ク 分 の デー タ を A1.L の アド レス へ 読 
み 込 み ま す 。 
1 プロ ッ ク の 容量 は 3 以上 を 指定 で きま せん 。 
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2N サ ーー rs ミコ ーー 


@ S WRITEEXT IOCS コ ー ル 番号 : $F 5 SCSI コ ー ル 番号 : $27 


拡張 WRITE コマ ンド 
0 


D1L 
D2.L 
D3L 
D4L 
DS.L 
A1L 


DOL 


$FS IOCS コ ー ル 番号 

$27 SCSI コ ー ル 番号 

目的 書き 込み 位置 (論理 プロ ッ ク 番 号 ) 
書き 込み プロ ッ ク 数 (論理 プロ ッ ク 数 ) 
ター ゲッ ト の ID 

1 プロ ッ ク の 容量 (0=256/1 三 512/2 三 1024) 
書き 込み 先頭 アド レス 


ステ ー タ ス (上 位 ニ テ メ ッ セー ジイ ン フ ェ ー ズ で 得 た 情報 下位 
ニス テー タス イン フェ ー ズ で 得 た 情報 ) 
ー1, 一 2 な ら 異 常 終了 


グル ー プ 1 の コマ ンド 。 書き 込み プロ ッ ク 長 は 65535 ま で 指定 可能 。 
D2L の 論理 ブロッ ク 番 号 か ら D3L プ ロッ ク 分 の デー タ を A1.L の アド レス へ 書 


き 込 み ま す 。 


1] セク タ の シフ トカ ウン ト は 3 以上 を 指定 で きま せん 。 


ea 


念 S REZEROUNIT IOCS コ ー ル 番号 : $F5 SCSI コ ー ル 番号 : $2B 


SCSI 装 置 を 指定 の 状態 に セッ ト 
DOL 


D1L 
D4.L 


$FS IOCS コ ー ル 番号 
$2B SCSI コ ー ル 番号 
ター ゲッ ト の ID 


ステ ー タ ス (上 位 ミ メッセ ー ジ イン フェ ー ズ で 得 た 情報 下位 
ニス テー タス イン フェ ー ズ で 得 た 情報 ) 
ー1 な ら 暴 常 終了 


SCSI 装 置 を 指定 の 状態 に セッ ト す る こと を 要求 し ます 。 
指定 の 状態 は 各 装 置 の 取扱 説明 書 を 参照 し て くだ さい 。 
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4. 4 SCSIIOCS コ ー ル 


1 


念 S REQUEST IOCS コ ー ル 番号 : $F5 SCSI コ ー ル 番号 : $2C 


SCSI 装 置 の セン ス デ ー タ を 調べ る 


por 
D1.L 
D3.L 
D4.L 
A1.L 


リタ ー ン | por 


$FS IOCS コ ー ル 番号 
$2C SCSI コ ー ル 番号 
読み 込み バイ ト 数 

ター ゲッ ト の ID 
読み 込み 先頭 アド レス 


ステ ー タ ス (上 位 ニ ミ メ ッ セ ー ジ イン フェ ー ズ で 得 た 情報 下位 
ニス テー タス イン フェ ー ズ で 得 た 情報 ) 
ー1 な ら 異 常 終了 


解 説 | AL の アド レス へ D3 エ の バイ ト 数 分 の REQUEST SENSE デ ー タ (SCSI 装 置 の 
セン ス デ ー タ ) を 読み 込み ます 。 


に 0 


念 S SEEK IOCS コ ー ル 番号 : $F5 SCSI コ ー ル 番号 : $2D 


指定 の 論理 プロ ッ ク ア ドレ ス ヘ シー ク す る 


bon 
19】 関 隊 
D2L 
D4.L 


$FS IOCS コ ー ル 番号 

$2D SCSI コ ー ル 番号 

目的 シー ク 位 置 (論理 プロ ッ ク 番 号 ) 
ター ゲッ ト の ID 


ステ ー タ ス (上 位 ニ メッ セー ジイ ン フ ェ ー ズ で 得 た 情報 下位 
ニス テー タス イン フェ ー ズ で 得 た 情報 ) 
ー1 な ら 異 常 終了 


D2 エ の 論理 プロ ッ ク 番号 に シー ク し ます 。 
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S_ STARTSTOP 


人 @ S STARTSTOP IOCS コ ー ル 番号 : $F5 SCSI コ ー ル 番号 : $2F 


SCSI 装 置 に 対し て 以降 の 操作 を 可能 、 ま た は 操作 を 不可 能 に する こと を 要求 


> 
十 


し ます 。 


DO 上 
D1.L 
D3L 
D4L 


DO.L 


$FS IOCS コ ー ル 番号 
$2F SCSI コ ー ル 番号 
操作 可 不 可 0 操作 不可 

1 操作 可 
ター ゲッ ト の ID 


ステ ー タ ス (上 位 ニ メッ セー ジイ ン フ ェ ー ズ で 得 た 情報 下位 
ー ス テー タス イン フェ ー ズ で 得 た 情報) 
ー1 な ら 異 常 終了 


入力 の の D3 上 が 1 の と き は SCSI 装 置 を 操作 で きる よう に 設定 し また 0 の と き は 
SCSI 装 置 を 停止 (操作 不可 ) する よう に 要求 し ます 。 


Na 


@ S REASSIGN IOCS コ ー ル 番号 : $F5 SCSI コ ー ル 番号 : $31 


2 


筑 
避 


CO 


8 


プロ ッ ク 再 配置 

DOL $FS IOCS コ ー ル 番号 
D1L $31 SCSI コ ー ル 番号 
D3L 書き 込み バイ ト 数 

D4L ター ゲッ ト の ID 

A1L 書き 込み 先頭 アド レス 


DOL 


ステ ー タ ス (上 位 ニ メッ セー ジイ ン フ ェ ー ズ で 得 た 情報 下位 
ニース テー タス イン フェ ー ズ で 得 た 情報 ) 
ー1 な ら 暴 常 終了 


欠陥 プロ ッ ク の 再 割 り 当 て を 要求 し ます 。 
A1L か ら D3 上 L の バイ ト 数 分 の 再 配置 プロ ッ ク デ ー タ を 書き 込み ます 。 


4. 4 SCSIIOCS コ ー ル 


ss 


@ S PAMEDIUM IOCS コ ー ル 番号 : $F5 SCSI コ ー ル 番号 : $32 
メデ ィ ア の イジ ェクト の 禁止 ・ 許 可 を 設定 
DOL  - sF5 IOCS コ ー ル 番号 


D1L $32 SCSI コ ー ル 番号 
D3 エ イジ ェクト 許可 プイ ジェ クト 禁止 0 イジ ェクト 許可 
1 イジ ェクト 禁止 
D4L ター ゲッ ト の ID 
リタ ー ン | DOL ステ ー タ ス (上 位 ニ メッ セー ジイ ン フ ェ ー ズ で 得 た 情報 下位 
= テス テー タス イン フェ ー ズ で 得 た 情報 ) 
ー1 な ら 異 常 終了 


メデ ィ ア の イジ ェクト 禁止 プ 許可 を 設定 し ます 。 入力 の D3 し が 0 の と き イ ジェ 
クト 許可 、1 の と き イ ジェ クト 禁止 に 設定 し ます 。 
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拡張 RS 一 232C 


ここ で は 、 拡 張 RS 一 232C コ ー ル の 使用 方 法 に つい て 説明 し ます 。 


IOCS コ ー ル 


拡張 RS 一 232C コ ー ル の ご 使用 に あたっ て は 、CONFIG.SYS へ の RSDRV.SYS の 登録 を 


行っ て く だ さい 。 


ドラ イ バ の 機能 は すべ て , IOCS コ ー ル (番号 $SF1) に よっ て 行い ます 。 


「C compiler PRO-68K ver2.1 NEW KIT] で は 、 次 の よう に し て 拡張 RS 一 232CIOCS コ ー 


ル を 利用 する こと が で きま す 。 


moved.1 22.D2 

moved.1 的 0n22.D1 * ま n は AUX No 
moveq. #SF1,DO0 

traD #15 


(拡張 RS-232C コ ー ル 番号 は 全て $F1 で す 。 ) 


例 ) AUX No1 に 対し て 、 各 種 設定 を 行い ます 。 
moveq.1 #$0130.JD2 * ネ AUX No 三 1.E_SET232C 
moveq. #$4807.D1 * 各 種 設定 値 
moveq.1 #$F1,DO *※ 拡張 RS 一 232C コ ー ル 
traDp #15 


IOCS コ ー ル の 詳細 説明 は 、「 プ ログ ラマ ー ズ マニ ュ ア ル 第 3 章 IOCS コ ー ル | を 参照 し て 


くだ さい 。 


⑱@ ラ イブ ラリ ー 覧 (アル ファ ベッ ト 順 ) 


名 前 | 機 能 ] 頁 
E_BUF232C 受信 デー タバ ッ フ ァ の 変更 294 
E_INP232C RS 一 232C 受 信 デ ー タ 取得 292 
E_ISNS232C RS 一 232C 受 信 デ ー タ チェ ッ ク 293 
E_LOF232C RS 一 232C 受 信 バ ッ フ ァ 内 デー タ 数 取得 292 
E_OSNS232C RS 一 232C 送 信 可 能 状態 チェ ッ ク 293 
E_OUT232C RS 一 232C デ ー タ 送信 294 
E_PINP232C RS 一 232C ポ ー ト の 状態 取得 296 
E_PSET232C RS 一 232C ポ ー ト の 状態 設定 297 
E_SET232C 通信 条件 の 設定 291 
E_VER232C | RS 一 232C て ドライバ の バー ジョ ン 番 号 の 取得 295 
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4. 5 拡張 RS 一 232C IOCS コ ー ル 


| 


通信 条件 の 設定 


Se 3 
D1.W RS 一 232C の 設定 値 


D2.W $On30  n:0 一 5 は AUX の 番号 


DOL 設定 前 の 通信 条件 


SET232C の 拡張 コー ル で す 。 | | 
RS 一 232C の モー ド を 設定 し ます 。 | | |47 
入力 の D1.W は 、RS 一 232C の モー ド を 設定 し ます 。 

D1.W に 一 1 を 設定 する と 、 前 の モー ド を 返す だ け で す 。 
設定 値 の 内 容 は 次 の 通り で す 。 


D15 D14 D13 D12 D11 D10 DO9 DO8 DO7 DO6 DO5 DO4 DO3 DO2 DO1 DOO 


ハー ド フ ロー (CTS/RTS) 処理 
0 : 処 理 し な い 
1 : 処理 する 


ボー レー ト 指 定 


SISO 処 理 (bps) 
0 : 処理 し な い 0000 = 75 
1 : 処理 する 0001 =150 
XON/XOFF 処 理 0010 = 300 
0 : 処理 し な い 0011 = 600 
1 : 処理 する 0100 = 1200 
ビッ ト 長 0101 = 2400 
00 : 5 ビッ ト 以 下 0110 = 4800 
パリ ティ 01 : 6 0111 = 9600 
01 ・ 奇 数 HO27 1000 19200 
11 ・ 偶 数 11:8 
00、10 : パリ ティ な し 
スト ッ プ ビッ ト 
01 SM 
10 ) 
00、11 :2 
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E_LOF232C 


RS 一 232C 受 信 バ ッ フ ァ 内 デー タ 数 取得 
DOL $F1 IOCS コ ー ル 番号 


D2.W $On31  n:0-5$ は AUXX の 番号 
DO.W デー タ 数 
LOF232C の 拡張 コー ル で す 。 


RS 一 232C の 受信 バッ ファ 内 の デー タ 数 
を 得 ま す 。 

リタ ー ン の DO0.W は 、RS 一 232C の 受信 
バッ ファ 内 の デー タ 数 で す 。 


E_INP232C 


RS 一 232C 受 信 デ ー タ 取得 
DOL SF1 IOCS コ ー ル 番号 


D2.W $0n32 n:0-5 は AUX の 番号 


DOB 受信 アー タ 


解 説 | INP232C の 拡張 コー ル で す 。 
RS 一 232C の 受信 デー タ を 得 ま す 。 
リタ ー ン の DO.W の 下位 8 ビッ ト の 
内 容 が RS 一 232C の 受信 デー タ で す 。 


292 


4. 5 拡張 RS 一 232C IOCS コ ー ル 


ea 


上 展 各 一 232C0 腕 條 ゲー クチ ェ ッ クタ 


DOL  $FI IOCS コ ー ル 番号 


D2.W $0n33 n:0 一 5 は AUX の 番号 


DO 受信 デー タ 

DO エ L = $000000 受信 デー タ な し 

DOL = $01002? 受信 デー タ あ り 
($27 は 受信 デー タ ) 


解 


書 


ISNS232C の 拡張 コー ル で す 。 RS 一 232C の 受信 デー タ を チェ ッ ク し ます 。 


E_OSNS232C 


RS 一 232C 送 信 可 能 状態 チェ ッ ク 


入 力 | DOL $FI IOCS コ ー ル 番号 
D2.W $On34 ni:0 一 5 は AUX の 番号 


リ ター ン | DOL 送信 可能 か どう か を 示し ます 。 
DOL=0 送信 で き な い 
DO0.L = $010000 送信 で きる 

(パッ ファ は 空 で 、 
XON で も な い ) 計 計 |47 


解 説 | OSNS232C の 拡張 コー ル で す 。 RS 一 232C に 送信 が 可能 か どう か チェ ッ ク し ま 
す 。 


293 


第 4 章 追加 DOS プ IOCS コ ー ル 


E_OUT232C 


RS 一 232C デ ー タ 送信 83 
DOL SF1 IOCS コ ー ル 番号 


D1.B 送信 デー タ 
D2.W $On35  n:0-5 は AUXX の 番号 


SRgSgESEES 


リ ター ン | な し (DOL の 内 容 は 保証 され ま せん ) 


解 説 OUT232C の 拡張 コー ル で す 。 
1 バイ ト RS 一 232C に 送信 を 行い ます 。 


る ぶち 避 を ちと ちら 


E_BUF232C 
受信 デー タバ ッ フ ァ の 変更 
DO エエ SF1 IOCS コ ー ル 番号 


D1L デー タバ ッ フ アァ 数 

D2.W $On36 ni:0-5 は AUX の 番号 

A1L デー クウ ャ ッ リ ス ア : の 
先頭 アド レス 


1) タ 一 ン | Dj エ 一 前 の デー タバ ッッ テア 数 
A1L 三 前 の デー タバ ッ フ ァ 
の 先頭 アド レス 


い 


RS 一 232C の 受信 デー タバ ッ フ ァ の 変更 を 行い ます 。 
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4. 5 拡張 RS 一 232C IOCS コ ー ル 


VER232 じ ーーーーーーーーーー 


31 


RS 一 232C ド ライ バ の バー ジョ ン 番 号 
の 取得 


DOL  $F1 IOCS コ ー ル 番号 
| 解 説 | 


D2.W $On37 nmn:0 一 5 は AUX の 番号 


ン | DOL バー ジョ ン 番 号 A2 

0 

解 説 | RS-232C ド ライ バ の バー ジョ ン 番 号 の 
を 取得 し ます 。 A7 


バー ジョ ン 2.00 な ら ば 、DOL = $0200 
バー ジョ ン 2.00 以 前 の と き は 、D0L = ー1 
どなり ます 。 
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第 4 章 追加 DOS プ IOCS コ ー ル 


E_PINP232C 
RS 一 232C ボ ポート の 状態 取得 
DOL $F1 IOCS コ ー ル 番号 


D2.W $On38  n:0O-5 は AUX の 番号 


リ ター ン | DO.W RS 一 232C の 状態 A0 
A1 

A2 

解 説 | RS-232C ポ ー ト の 状態 を 取得 し ます 。 人 
リタ ー ン の DO0.W は 、RS 一 232C の 状態 

デー タ で 、 内 容 は 次 の 通り で す 。 27 


b15 bl14 b13 b12 b11 b10 bO9 b0O8 b07 b06 b05 b0O4 b03 b02 bO1 bOO 


DO.W 


送信 中 断 要求 状態 
0 : 送信 中 断 要求 を 受信 し て いな い 
] : 送信 中 断 要求 を 受信 し た 
DSR 状 態 
0 : DSR OFF 
1 : DSR ON 
CD 状態 
0 : 受信 キャ リア な し 
1 : 受信 キャ リア あり 
(た だ し , B チ ャ ネル の と き は 常に 0 ) 
CTS 状 態 


0 :CTS OFF 
EESIGON 
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4. 5 拡張 RS 一 232C IOCS コ ー ル 


2 


31 16 15 8 7 0 


RS 一 232C ポ ー ト の 状態 設定 po 
D1 
六 D2 
DOL $Fl IOCS コ ー ル 番号 | 
D1.W 民 き 一 0 ト の 還 
設定 デ p7 
D2.W $0n39 00 | Ao 
Al 
| ん 2 
な し (DOL の 内 容 は 保証 され ませ ん ) | 了 
| | 45 
ー | | A6 
解 説 | RS 一 232C ポ ー ト の 状態 を 設定 し ます 。 | |47 
設定 デー タ の 内 容 は 次 の 通り で す 。 
b15 bl14 b13 b12 bl1 b10 bO9 b08 b0O7 bO6 b0O5 b04 b03 b0O2  b0O1 
elle 中 
DTR 状 態 
0 :DTR OFF 
1 : DTR ON 


SBR 状 態 
0 : プレ ー ク 信号 送信 し な い 
1 : プレ ー ク 信号 送信 する 
RTS 状 態 


0 : RTSOFF 
1 : RTSON 
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四国 衝 ら 


X68K ン リー ズ ソ フト ウェ ア 互 換 の た め の 注 意 点 


拡張 SRAM 資 料 
OPMDRV3 サ ンプ ルプ ログ ラム 
SCSI サ ンプ ルプ ログ ラム 
エエ ラー メッセー ジ 一 覧 


X68K シ リーズ ソフ トウ ェ ア 互 換 の た め の 注 意 点 
旧 二 較 MPU680X0 で の ソフ トウ ェ ア 互 換 の た め の 注 意 店 


X68030 で は 、CPU に 32 ビ ッ ト MC68EC030 を 搭載 し て いま す 。 従来 の X68000 で 使 
われ て いた MC68000 と は 互換 性 が ある の で 、X68000 で 動作 する ソフ トウ ェ ア は 基 
本 的 に X68030 で 動作 し ます が 、 ソ フト ウェ ア の プロ グラ ミン グ に よっ て は 、 動 作 
する も の と し な いも の と が 出 て きま す 。 こ こ で は 、X68030 プ X68000 で プロ グラ ミ 
ング する うえ で 、 ソ フト ウェ ア の 互換 性 を 保つ た め の 制 限 を 説明 し ます 。 


@MPU68000 フ ァ ミ リ 

MPU68000 シ リー ズ は 、00、10、20、30、40 な どの MPU フ ァ ミ リ を 持っ て お り 、 
その オプ ジェ クト コー ド は 上 位 互換 性 が あり ます 。 

し か し 、 完 全 な 互換 で は な いた め 、 ソ フト ウェ ア の 互換 性 を 保つ に は 、MPU の 使 
い 方 (プロ グラ ミン グ の 方 法 ) に 注意 する 必要 が あり ます 。 で きる だ け 次 の 様 な 
点 を 考慮 し て プロ グラ ミン グ を 行っ て くだ さい 。 
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付録 1 X68K シ リー ぞ ソ フト ウェ ア 互 換 の た め の 注 意 点 


上 位 の CPU を 考え た 場合 の 注意 点 


@ ス テー タス レジ スタ (SR) の 取り 扱い 

ステ ー タ スレ ジス タ は 、68020 以 降 の MPU で 未 使用 の ビッ ト を 使用 し て いま す 。 
その た め 、 未 使用 ビッ ト を 不 必要 に セッ ト 、 ま た は クリ ア す る コー ド を 書か な い 
で くだ さい 。 た と えば 、List 1 の よう な 未 使用 ビッ ト ま で 書き 込み を 行っ て し まう 
コー ド の 使用 は 避け て くだ さい 。 


・ 未 使用 ビッ ト を クリ ア す る コー ド の 例 (割り 込み 禁止 に する ) 


move #2700, sr 


鎧 MOVE from SR 命令 の 使用 禁止 

この 命令 は 、68010 以 降 で は 特権 命令 に な っ て いま す 。 し た が っ て 、 ユ ー ザ ー モ ー 
ド で の この 命令 の 挙動 が 、68000 と 68010 以 降 で は 異な り ま す 。 

Human68k ver3.0 で は 、 こ の 命令 を スー パー バイ ザー モー ド で MOVE from CCR 命 
令 に 書き 換え 実行 し ます (List2) 。 


・MOVE from SR (コン ディ ショ ンコ ー ド を セー ブ す る ) 


move Sr, 一 (SD) /\* Human68K ver3.0 は 、move ccs, 一 (SD) * 
グ \ に 書き 換え 実行 し ます * ブ 


rtr 


価 六 り 込み な どの 例外 処理 

68010 以 降 で は 例外 処理 に 入っ た と き 、 ス タッ ク に は 68000 と は 異な り ベ クタ オフ 
セッ ト の 情報 が 余分 に 入っ て いま す 。 し た が っ て 、 ス タッ ク に 積ま れ て いる 情報 
を 確認 し た うえ で 例外 処理 を 行わ な いと 、 フ ォ ー マ ッ ト エ ラー 例外 や パラ メー タ 
の 受け 渡し が うま く で き な く な り ま す 。 ま た 、RTE 命 令 は 例外 処理 か ら の リタ ー 
ン の み に 使用 し ます 。 さ ら に 、 ス テッ プ 数 を 少な くす る た め List3 の よう な こと と を 
条 わ な いよ うに し で ぐだ さゆ 。 


・ フ ォ ー マ ッ ト エ ラー 例外 が 起こ る コー ド (割り 込み 禁止 ルー チン ) 


move SF, 一. (SB) 
Ori # 准 0700, sr 
re ノン * フォ ー マ ッ ト エ ラー 例外 が 起こ る * ノ 
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@ ア ドレ ス の 上 位 8 ビ ッ ト の 取り 扱い 

68000 で は アド レス 空間 が 16M バ イト で あり 、32 ビ ッ ト の アド レス の 上 位 8 ビ ッ ト 
に どん な 値 が 入っ て いて も 問題 な く ア クセ ス す る こと が で きま し た が 、 将 来 的 に 
4G バ イト の メモ リ 空 間 を 考慮 し て 、 上 位 8 ビ ッ ト は 0 で 埋め て くだ さい 。 たとえ 
ば 、OS が MMU を サポ ー ト し た 場合 、 上 位 き 8 ビッ ト に ゴミ や フラ グ が 入っ て いた と 
き 、OS の メ モリ 管理 が 難し く な り 、 新 し い シ ステ ム で 動作 し な く な る 可能 性 が あ 
り ま す 。 ア ドレ ス の 上 位 8 ビ ッ ト は 予約 され て いる も の と し て 、0 で 埋め て お いて 
くだ さい 。 

$01000000 一 $FFFFFFFF の 空間 は 、 す で に 予約 され て いま す 。 


@ キ ャ ッシュ の 挙動 に つい て 

実行 速度 向上 の た め 、68020 以 降 で は オン チッ プ キ ャ ッシュ メモ リ が 搭載 され て い 
ます 。 プ ログ ラミ ング する うえ で 、 こ の キャ ッシュ メモ リ の 次 の よう な 挙動 に 注 

意 し て くだ さい 。 

・68030 以 降 で は デー タキ ャ ッシュ に プロ グラ ム が ロー ド さ れ て も 実行 され ませ 
ん 。 

・ 同 一 アド レス の デー タ を 、 ス ー パ ー バ イザ ー プ ログ ラム と ユー ザー プロ グラ ム 
が 共有 する と き に は 、 デ ー タ キャ ッシュ に は 違う 領域 が 割り当て られ る の で 、 双 
方 の プロ グラ ム で デー タ の 相違 が で て きま す 。 ま た 、DMA を 使っ て メモ リ を 書 
き 換え た 場合 も 同様 で す 。 


人 @ 自 己 改変 コー ド の 使用 禁止 

68020 以 降 で は イン スト ラク ショ ン キ ャ ッシュ を 備え て いる の で 、 コ ー ド を 短く す 
る た め に 自分 自身 の プロ グラ ム を 書き 換え る よう な プロ グラ ム (List4 ) を 使っ た 
場合 、 書 き 換 を た プロ グラ ム が キャ ッシュ メモ リ 上 に ある と 正常 に 動作 し ませ 
ん 。 こ れ は 、 指 定 し た メモ リ の 内 容 が 書き 変わ っ て も 、 す で に キャ ッシュ に 読み 
込ま れ た 部 分 は 書き 換え られ な いた めで す 。 


・ プ ログ ラム の 分 岐 先 を 変え る 


lea jobI(pc), al 
lea prg_exit 十 2(pc), a0 


move.| al, (a0) ノン \ イン スト ラク ショ ン キ ャ ッシュ に \ 
prg_exit: jmp job2 グ テ * 入っ て いる と 必ず job2 に 分 岐 す る * ブ 
job1: nop 
job2: nop 
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付録 1 X68K シ リー ダ ソ フト ウェ ア 互 換 の た め の 注 意 点 


アド レス エラ ー に つい て 

68020 以 降 で は 、 奇 数 アド レス か ら ワ ー ド デー タ を 取り 出す こと と が で きる よう に 
な っ て いま す が 、68000、68010 で は アド レス エラ ー と な り ま す 。 た と え 、MPU を 
判断 し て 奇数 アド レス の ワー ド デ ー タ を アク セス し て も 、 パ フォ ー マ ン ス の 低下 
だ け で 何 の メ リッ ト も あり ませ ん 。 


信 CALLM、RTM 命 令 の 使用 禁止 
これ ら の 命令 は 、68020 の み の 命 令 で 68030 以 降 で 廃止 きれ て いま す の で 、 使 用 し 
な いで くだ さい 。 


供 拡 張 さ れ た アド レッ シン グ 命 令 の 取り 扱い 
パフ ォ ー マ ンス の 向上 の た め 、68020 以 降 で 拡張 され た アド レッ シン グ や 命令 を 使 
うこ と は 有効 で す が 、MPU の 種別 を あら か じ め 判 別 し 、 使 用 し て くだ さい 。 
何 も 判 別 し な いで 拡張 部 分 を 実行 され た と き 、 下 位 の MPU で は 動作 し ませ ん 。 
・MPU が MC68030 以 上 な ら 1 を 、 そ う で な いな ら 0 を 返す 

才 nclude く jocslib.h> 

#define MC68000 

#define MC68010 

#define MC68020 

#define MC68030 

#define MC68040 


int isMPU68030( void ): 
void test( void ): 


int isMPU68030( void ) 
( 


int value: 


value 三 MPU_STAT() & 0xff: 


if( value > MC68030 ){ 
return 1: 
)elset{ 
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return 0: 
] 
} 


void test( void ) 
{ 
if( isMPU680300) ){ 
/\ MC68030 用 の プロ グラ ム */ 


jelse{ 
/X MC68000 用 の プロ グラ ム */ 


] 


付録 1 X68K シ リー ソフ トウ ェ ア 互 換 の た め の 注 意 点 


ハー ドウ ェ ア を 考え た 場合 の 注意 点 

⑱MPU の 処理 速度 

MPU の 種類 や 動作 クロ ッ ク が 違う と 、 当 然 処理 能力 も 違っ て きま す 。 そ の た め 、 

周辺 IC の デー タ 設 定 な ど に は 注意 を 要 し ます 。 例え ば 、RTC (リア ル タ イ ムク 
ロッ ク ) な ど は アク セス 間隔 を 1/s 以 上 開け な いと いけ ませ ん 。 そ の た め に 、 処 理 
の 速い MPU を 想定 し て 時 間 計 算 を し た り 、 シ ステ ム で 用 意 し て いる ルー チン を で 
きる だ け 使 用 し て くだ さい 。 今後 、MPU だ け で ルー プ な ど に よる 時 間 管 理 を 行う 
こと は 難し く な り ま す 。 


その 他 の 注意 点 


亀 1111 1111 01xx xxxx パ ター ン の DOS コ ー ル に つい て 

この パタ ー ン は 、68020, 68030 で は cpRESTORE に 割り 当て られ て いま す が 、 そ れ 
ら の CPU で は コ プ ロ セッ サ の アク セス の 前 に 実効 アド レス の アク セス が あり ます 

の で 、 も し 実効 アド レス 先 で エラ ー と な る と DOS コ ー ル は 実行 さき れ ま せん 。 

これ に 対処 する た め に Human68k ver.3.0 で は この パタ ー ン に 適合 する DOS コ ー ル 
($FF50 一 $FF7F) は 、$FF80 一 $FFAF に 移動 さき て て いま す 。 

Human68k ver.3.0 で この 命令 を 使用 する と き は 、 ユ ー ザ ー モ ー ド で 行っ た 場合 の み 

正しく エミ ュ レ ー ト され ます 。 

スー パー バイ ザー モー ド で 利用 する 場合 は 、 移 動 し た DOS コ ー ル ($EFF80 一 

$FFAF) を 必ず 利用 し て くだ さい 。 

また 、 新 し く DOSINIT( ) 関 数 が 、"CLIBL" に 用 意 き れ て いま す 。 

各 DOS コ ー ル を 呼ぶ 前 に 、 こ の 関数 を コー ル す る こと に より 、 ど の バー ジョ ン の 

Human68K で も 新しい DOS コ ー ル 番号 で 使用 する こと が 可能 に な り ま す 。 

_ _MAIN.O か ら 始 まる プログ ラム で な い めい 通常 の アセ ンプ ラプ ログ ラム を 書く 場合 

で 、 ス ー パ ー バ イザ ー モ ー ド 参照 関数 を アク セス する 可能 性 が ある と き は 、 必 ず 

この 関数 を コー ル し た 後 で 使用 し て くだ さい 。 
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拡張 SRAM 資 料 


アド レス | サイ ズ 、 初 期 値 意 味 


$ED0072 2 "SS 識別 子 


$EDO0074 1 6 マウ スポ イン タ の 移動 量 ( 遅 $03ー$0A 速 ) 


$ED0075 1 6 マウ ス の ダブ ルク リッ ク 間 隔 ( 短 $00 一 $0C 長 ) 


$ED0076 1 96 パレ ッ ト の H ($00 一 $BF) 


$ED0077 。 交 パレ ッ ト の S ($00 一 $1F) 


$ED0078 1 %11111 110 パレ ッ ト の V0.1 ($88 一 $FF) 


$ED0079 1 %00.10000.0 パレ ッ ト の V1.2.3 ($82 一 $BA) 


$ED007A 1 %0000_0000 パレ ッ ト の VS3 ($00 一 $EO) 


$ED007B 1 50 プリ ンタ ドラ イ バ (PRTD) の ID 
・SHARP CZ 24 ピ ビン 
・EPSON ESC/P24 一 J83 ・C 
・NEC PC 一 PR ネ ポ 玉 末 
・SHARP CZ 48 ピ ン 
・CANON BJ 一 ※ 玉 玉 
・EPSON ESC/P24 一 J84・C 

・ ADOBE PosIScript 
・CANON LIPS3 

・EPSON ESC/Page 


oo ココ の いひ の みゆ の (いら ー の の 


$ED007C 1 %0010_0011 上 位 4 ビ ッ ト ニ バー ジョ ン 番 号 
%0000 SXWIN.X Ver.1.0 
%0001 SXWIN.X Ver.1.1 
%0010 SXWIN.X Ver.3.0 

下位 4 ビッ トニ ファ イル 保存 モー ド 
ビッ ト 1 : DIRDTOP.SX 保 存 
ビッ ト 0 : SYSDTOP.SX 保 存 


0 : シス テム 0 
$ED007D 1 0 背景 ピク チャ ー の ID 】: シス テム 1 
2 : ユー ザー 定義 


$ED007E 1 0 SX メ ーWINDOW 画面 モー ド 
ビッ ト 7:0……768X512、16 色 
1 下位 ビ ッ ト の 画面 モー ド 
ビッ ト 6 : 0'… 表 示 画 面 モ ー ド 
1… 実 画面 モー ド 
ビッ ト 05 : IOCS コ ー ル の CRTMOD に 同じ 
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付録 2 拡張 SRAM 資 料 


アド レス | サイ ズ 、 初 期 値 | 意 味 
シス テル 予約 
9 0.000 ンド ウマ ー ジ ン 2byte X 4 
( 堪 、 四 避 時 右 、 下 ) 
4 $100000 メモ リ の リミット アド レス 十 1 が 入る ワー ク 
$200000 
(XVICompacb) 
$400000 
(X68030) 
4  $BFFFFC ROM プ ー ト の スタ ー ト アド レス が 入っ て いる ポ 
イン タ の ワー ク 
$FC0000 
(XVI 以 降 ) 
1 1 SCSI ハ ー ド ディ スク が 何人 台 つ な が っ て いる か の ス 


0 (XVL 以降 ) 


イッ デ ャ ュ 
(0 一 15) まで 可能 で 、 指 定 台 数 以上 は IOCS コ ー 
ル の レベ ル で エラ ー に な り ま す 。 


2 不定 拡張 RS232C 設 定 
2 不定 拡張 RS232C 設 定 
2 不定 | 拡張 RS232C 設 定 
2 不定 拡張 RS232C 設 定 
b15b14 : スト ッ プ ビッ ト 01 ニ 1 ビッ ト 
10 三 1.5 ビ ッ ト 
OO0.11 三 2 ビット 
b13b12 : パリ ティ 01 三 奇数 
11 三 偶数 
00,10 ニ な し 
b11b10 : ビッ ト 長 00=5 ビ ッ ト 
01 ニ 6 ビッ ト 
10 三 7 ビ ツ ド 
11= ニ 8 ビッ ト 
b09 : XON 処 理 1 三 XON/XOFF (ソフ ト フ ロー) 
制御 する 


b08 : SISO 処 理 1 三 SISO 制 御 す る 
b07: ハー ド フ ロー 処理 
1 三 CTSJRTS (ハー ギド ラフ 呈 ー) 
制御 する 
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アド レス | サイ ズ 、 初 期 値 意 味 


b03b02b01b00 : ボー レー ト 0000=75 

0001 三 150 
0010=300 
0011 三 600 
0100 ニ 1200 
0101 ニ 2400 
0110 三 4800 
0111=9600 
1000=19200 


$EDOO6F SCSI ス イッ チ 有 効 


$ED0070 1 不定 本 体 ID の スイ ッ チ 
(b7-b4 は X68030 以 降 の み 有 効 ) 
b7 : DMA 1 回 あたり の 転送 語数 
0=256 バ イト 固定 
1=$CCO.w に 指定 され た 転送 語数 
b6 : プー ト 時 の デバ イス タイ プ の 無視 
0 三 0.4,5,7.$84 の み プ ブー ト 
1 ニ = デバ イス タイ プ を 無視 する 
bS : DMA バ ー ス トモ ー ド (現在 は 0 固定 ) 
0 テニ バ ー ス トモ ー ド 使用 し な い 
1 ニテ バー スト モー ド 使 用 する 
b4: ソ フト 転送 モー ド 
0=DMA 転 送 を 使用 する 
1= ソ フト ウェ ア 転 送 を 使用 する 
b3 : 内 蔵 プ オプ ショ ン イ ンタ ー フ ェ イ ス 
0= ニ 内蔵 イ ンタ ー フ ェ イ ス 
三光 5Z グ ショ シイ ンタ テー フェ イス 
b2blb0 : 本 体 の SCSI ID 


$ED0071 | 1 不定 SASI ド ライ ブ の 指定 スイ ッ チ 
四 ビッ ト 番 号 が SASI ID 番号 に 対応 し ます 。 
$ED0072 30 SXーWINDOW が 使用 する ワー ク 
ー$EDO008F 
$ED0090 1 0 起動 時 の キャ ッシュ の 設定 CX68030 の み 有 効 ) 
b1: デ ー タ キャ ッシュ 0 三 無 効 
1 三 有効 
b0 : 命令 キャ ッシュ 0 三 無効 
1 三 有効 
$ED0091 1 0 起動 時 サウ ンド 設定 0 三 OFF,0 以 外 ON 
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付録 2 拡張 SRAM 資 料 


アド レス | サイ ズ 、 初 期 値 意 味 


$EDO0092 2 0 XF3 を 押し な が ら リ セッ ト 起 動 し た と き の 
ウェ イト 数 (X68030 の み 有 効 ) 

0 の 場合 、10 の ウェ イト 数 (10MHz 相 当 ) で 
起動 し ます 。 


$EDO0093 2 0 XF4 を 押し な が ら リ セッ ト 起 動 し た と き の 
ウェ イト 数 (X68030 の み 有 効 ) 

0 の 場合 、4 の ウェ イト 数 (16MHz 相 当 ) で 
起動 し ます 。 


この 他 の SRAM の 利用 内 容 に つい て は 、「 プ ログ ラマ ー ズ マニ ュ ア ル 」]| の 「 付 録 5 
SRAM の 内 容 ] を ご 参照 くだ さい 。 
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OPMDRV3 サ ンプ ルプ ログ ラム 


Music Sample 


* * お お 、 ス ザン ナ ! ! "S.C.Foster 
レゴ / 

#include ぐ stdioh 

#include ぐ stddef.h 

nclude ぐ stdlib.h 

#include ぐ sring.h 

社 nclude く music.h 

# お include く music3.h 


#define NASI (CN' く く 24) 十 A' く く 16) 十 (S ぐ ぐ ⑧ 十 ) 


char r[256] ,as [256] ,bs [256] ,cs [256] ,ds [256] ,part [256] : 


/* ネ 
Main 
ネ / 
int 
main( void ) 
( 


m_init( 1 ): // ぐ -- Not Compatible OPMDR V1., 2 
m_sysch("OPM'): 

m_alloc(10.2000): 

m_assign(10,10): 


printf( "演奏 チャ ン ネ ル を 指定 し て くだ さい ーーーーー 一 10 

fgets( r, 253, stdin ): 

printf( "音色 番号 を 入力 し て くだ さい (1 一 2 0 Oo 二 ジ 008 

fgets( as, 253, stdin ): 

NN 了 K" チ ジン 事 入 放し て くだ る w ぬ (29 一 300) 一 ーー ニーーー み 71 
fgets( bs, 253, stdin ): 

putchar( \n' ): 


char rack [256] : 


sprintf( rack, "④N%s@%so4 v9 q7 116t%s", tr, as, bs ): 
310 


ネ / 


付録 3 OPMDRV3 サ ンプ ルプ ログ ラム 


m_trk( 10, rack ): 
1) 
m_trk( 10, "gw&a b8 ぐ d8d8e8 > ぐ d8>b8g8.a b8b8a8g8 a4.ga 称 " ): 
m_tk( 10, "b8 く d8d8.e> く d8>b8g8.a& b8b8a8a8 g4.ga 和 &" ): 
m_rk( 10, "b8 く d8d8.e> ぐ d8>b8g8.a b8b8a8g8 a4r8ga&" ): 
m_trk( 10, "b8 ぐ d8d8e8 > ぐ d8.>bg8.a bb8.a8.a g4r4" ): 
m_rk( 10," ぐ c4c4> ぐ e8e4e8 > ぐ d8.d>b8g8 a4r8ga 肌 " ): 
m_trrk( 10, "b8 ぐ d8d8.e> ぐ d8>b8g8a8 b8b8a8.a g4r8" ): 


m_play( NASI, NASI, NASI, NASI, NASI, NASI, NASI, NASI ): 


while( m_stat( NASI ) ! ニ 0 ) { 
printf( "演奏 を 終了 し ます か (Y ノ N) ?"): 
fgets( cs, 233, stdin ): 


if( srncmp( cs,"Y",1 ) ニー ニ 0istrmcmp( cs, "y",1) モデ 0){ 
m_stop( NASI, NASI, NASI, NASI, NASI, NASI, NASI, NASI ): 
break: 

) else { 
m_cont( NASI, NASI, NASI, NASI, NASI, NASI, NASI, NASI ): 


return EXIT_SUCCESS: 


End of File 
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サン プル プロ グラ ム 


XC ラ イプ ラリ ディ スク の <SAMPLE> デ ィ レ クト リ の 中 に 、2 本 の サン プル 
プロ グラ ム "SCSI1.C","SCSI2.C" が 添付 され て いま す 。 


SCSI1.C は 、SCSI コ ー ル 番号 $20 以 上 の 高 レ ベル な ライ ブラ リ を 用 いた サン 
プル プロ グラ ム で す 。 
SCSI デ ー タ の ダン プ 表 示 や SCSI 装 置 情報 の 表示 な ど を 行い ます 。 


SCSI1 ぐ SCSI ID 番号 > [< く プ ロッ ク 番 号 >] 


引数 に SCSIID 番 号 の み を 指定 し た 場合 は 、SCSI 装 置 情 報 を 表示 し ます 。 
プ ブロック 番号 も 指定 し た と き は 、 そ の プ ブロッ ク 番 号 の デー タ を 表示 し ま 
k 

その 後 は 以下 の キー に て 操作 する こと が で きま す 。 


ROLLUP,RETURN ・ 次 の プ ブロック 番号 の デー タ を 表示 
ROLLDOWUN.,UNDO : 前 の プロ ッ ク 番 号 の デー タ を 表示 
ESC ・ 終 了 


例 1) SCSI 装 置 の ID 番号 0 の 装置 情報 を 表示 。 


ASCSI1 0 
SCSI Library sample 1 version 1.XX by SHARP 
ID 番号 : 0 


最大 プロ ッ ク 数 : 167720 

プロ ッ ク サ イズ : 312 バ イト 

最大 容量 ・81M バ イト 

周辺 装置 機種 直接 アク セス 装置 
媒体 の 取外し  : 不 可 

ANSI 規 格 ・ 合 致 

A> 


付録 4 SCSI サ ンプ ルプ ログ ラム 


例 2 ) SCSI 装 置 の ID 番号 0 、 プ ロッ ク 番 号 4 の デー タ を 表示 。 


A>SCSI1 0 4 
SCSI Library sample 1 version 1.XX by SHARP 
[ID=0] [BLOCK=4] [MAX BLOCK=167719] [BLOCK 


SIZE=S$12] [最大 容量 =81Mbyte] 
BLOCK 二 n 十 0 十 1 十 2 十 3 十 4 十 $ 十 6 填 7 十 8 十 9 十 A 士 B 二 C +D 
寺 E 十 EF ASCII charactor 
00000000 58 36 38 4B 00 01 40 20 00 01 47 93 00 01 47 93 X68K..@ .…G ..G 滴 
00000010 48 75 6D 61 6E 36 38 6B 00 00 00 20 00 00 A0 00 Human68k.… .… . 
00000020 48 75 6D 61 6E 36 38 6B 02 00 A0 20 00 00 A0 00 Human68k.. .. . 
00000100 91 95 92 75 91 53 91 CC 82 CC 97 65 97 CA 20 20 装置 全体 の 容量 
00000110 20 20 20 20 20 20 20 20 20 20 38 31 20 82 6C 83 81 M バ 
00000120 6F 83 43 83 67 00 00 00 98 41 91 B1 8A6D95 DB o イ ト .… 連 続 確保 
00000130 89 C2 94 SC 82 C8 8DCS 91 ES 97 65 97 CA 20 20 可能 な 最大 容量 
00000140 20 20 38 31 20 82 6C 83 6F 83 43 83 67 000000 81M バ イト .… 
000001F0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 .…………… 

キー 入力 待ち 。 


また SCSI2 は 、SCSI コ ー ル 番号 $20 未 満 の 低 レ ベル な ライ ブラ リ を 用 いた サン 
デル プ 品 グラ ム で す 。 
書式 は 、SCSI1 と 同様 で す 。 
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1 
2 
3 
4 
5) 
6 
7 
8 
9 
0 
1 
2 
3 
4 
5 
6 
7 
8 
9 
0 
1 
2 
3 
4 
5 
6 
7 
8 
9 
0 


1 
1 
1 
1 
1 
1 
1 
| 
1 
2 
2 
2 
2 
2 
2 
2 
2 
2 
2 
3 


Co Co OO 
um 心 〈 〇 いも ピ 


テン ポ の 指定 が 無効 で す 

トラ ッ ク 番 号 が 無効 で す 
OPMDRV3.X が 登録 さき れ て いま せん 
サイ ズ の 指定 が 無効 で す 
メモリー の 確保 が で きま せん 
チャ ン ネ ル 番 号 が 無効 で す 
配列 の 指定 に 誤り が あり ます 
OPMDRV3.X は 現在 停止 中 で す 
ベロシティ の 値 が あり ませ ん 
ベロ シテ ィ の 値 が 無効 で す 

水 音 モー ド の 指定 が 無効 で す 
録音 の 準備 が で き て いま せん 
パン ポッ ト の 値 が あり ませ ん 
パン ポッ ト の 値 が 無効 で す 

トラ ンス ポー ズ の 値 が あり ませ ん 
トラ ンス ポー ズ の 値 が 無効 で す 
パラ メー タ を 両方 省略 する 事 は で きま せん 
パラ メー タ の 指定 に 誤り が あり ます 
MML の 文法 に 誤り が あり ます 
[] の 中 の 指定 に 誤り が あり ます 
] が あり ませ ん 

繰り 返し の 値 が 無効 で す 

繰り 返し 番号 の 指定 が あり ませ ん 
繰り 返し 番号 の 指定 が 無効 で す 
オク ター プ ブ の 番号 が あり ませ ん 
オク ター プ の 指定 が 無効 で す 
長 さ の 値 が 無効 で す 

トラ ッ ク 容 量 が 足り ませ ん 

音色 番号 の 指定 が あり ませ ん 
@W の 値 が あり ませ ん 

@W の 値 が 無効 で す 

テン ポ の 値 が あり ませ ん 

テン ポ の 値 が 無効 で す 

長 さ の 値 が あり ませ ん 
音量 の 値 が あり ませ ん 


付録 6 エラー メッ セー ジー 息 


音量 の 値 が 無効 で す 
キー コー ド の 値 が あり ませ ん 
キー コー ド の 値 が 無効 で す 
音色 番号 が 無効 で す 
| が あり ませ ん 
叶 の 中 に 音符 が 多 す ぎ ま す 
全 の 中 に 音符 が あり ませ ん 
Q の 指定 に 誤り が あり ます 
上 の 中 の 文法 に 誤り が あり ます 
Y の 指定 に 誤り が あり ます 
@L の 指定 に 誤り が あり ます 
P の 指定 に 誤り が あり ます 
タイ の 指定 に 誤り が あり ます 
和音 の 指定 に 誤り が あり ます 
和音 の 数 が 多 す ぎる か 、 ま た は 後 の ' が あり ませ ん 
(@V の 指定 に 誤り が あり ます 
(@P の 指定 に 誤り が あり ます 
@U の 指定 に 誤り が あり ます 
(@N の 指定 に 誤り が あり ます 
(@M の 指定 に 誤り が あり ます 
@D の 指定 に 誤り が あり ます 
(@B の 指定 に 誤り が あり ます 
(@T の 指定 に 誤り が あり ます 
@Y の 指定 に 放り が あり ます 
PCM の バッ ファ 不足 で 、 こ れ 以 上 登録 で きま せん 
PCM は 使用 で きま せん 
OPMDRV3.X の バー ジョ ン が 違い ます 
無効 な サン プリ ング 周波 数 を 指定 し まし た 
無効 な 出力 モー ド を 指定 し まし た 
無効 な デー タ サ イズ を 指定 し まし た 
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の の 回 門 到 エラ ー コ ー ド 


パラ メー タ エ ラ ー | ュー に on メー タ の 値 が 不適 切 パラ メー タ の 値 を 確か め て 
ら (《 だ さい 。 


2 マス タ ま た は スレ ー プ モー ド で は 実行 
- で きま せん 。 
転送 デー タ が 失わ れ た 場合 に 発生 し ま 


2 す 。 用 行 で きま せん 。 


ンー 


4 


デー タ 転 送 中 に 何ら か の 割り 込み |gp_st を 実行 する こと に 


1 
バス の ハン ド シ ェ イク が 中 止 し 、 あ る | 
時 間 以 上 経過 し た 場合 に 発生 し ます 。 | 行き ます 。 
5 


転送 中 断 エ ラー (DCL、TRG な ど ) が 入っ た 場合 に 発 | より 割り 込み 要因 が わか り 


GPIB ドラ イ バ が 組み 込ま れ て いま せこ と 2A ん で (だ さ 


ん 。 旨 


_- _open を 実行 し て 〈 
初期 化 エラ ー に 天 gp_open が 実行 され て いま せん 。 た 
CONFIG.SYS に アバ イス ド 
関数 名 が 無効 _ フ 
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付録 5 エラ ー メ ッ セ ー ジ 一 覧 
5 一 3 SCSI エ ラー コー ド 
上 位 三 INTS(SPC の 割り 込み 原因 ) 


D23 D22 D21 D20 D19 D18 回 D16 


TH lllIII 


一 実行 し よう と する 転送 フェ ー ズ と SCSI 上 で 要求 
され て いる 転送 フェ ー ズ と が 不一致 、 あ る い は 転送 
実行 中 に 他 の 転送 フェ ー ズ が 要求 され た と き の 割 り 込 み 


RESET コン ディ ショ ン 割 り 込み 


SPC ハー ドウ ェ ア 割 り 込み 


ーーー セ レク ショ ン タイ ム ア ウ ト 割 り 込 み 


SPC に 対す る コマ ンド の 動作 の 終了 割り 込み 


DISCONNECTFD 割り込み 


RESELECTED 割り 込み 


SELECTED 割り 込み 


各 ビ ピット は 0………… 割り 込み 無し 
昌 200kmoate 割り 込み 有り 


下位 三 PSNS(SCSI バ ス 上 の 制御 信号 の 状態 ) 


D7 D6 D5 PD4 D3 PD2 D1 DO 


FNs | 0 | 0 keohcklmlsmr 


moy vs lep | o | 


各 ビ ッ ト は 0 oe 信号 ノン アク ティ プ 
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. 鞭 一 ー す ck 一 で エ さ 軒 


evota 覆 vmswemfexPsir io ra 旨 ーー の q デズ デニ ニー ズー デ 
| コー ヒー マコ CO8 


0 


LE 補 サメ と 2 は 


emo 


社 
人 


ず 問 い 合わ せ 先 


〒545 大 阪 市 阿倍 野 区 長池 町 22 番 22 号 


〒329-?1 栃木 県 矢板 市 早川 町 174 番 地 
AVC シ ステ ム 事 業 推進 室 

〒162 東京 都 新宿 区 市 谷 八 幡 町 8 番地 電話 (03)3260-1161( 大 代表 ) 
市 ヶ 谷 ビル 内 電子 機器 事業 本 部 AVC シ ステ ム 事 業 推進 室 


ソフ トウ ェ ア 担 当 


